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INTRODUCTION 


Frequently, a lack of adequate information results in much time 
being spent resolving software problems. This manual is an aid in 
solving these problems. It includes assorted items of information 
about the Master Control Program (MCP) Tables, segments, links, 
words, and related material, which, together with a listing of the 


MCP, will make it easier to define software problems. 


Specifically, this reference manual is divided into nine sections, 
which focus on the MCP Tables, the Disk, MCP classification and 
Organization of Core Storage, Logging, MCP Operational Tables, Binary 
Cards, Library Maintenance, and Interrupt Handling. In addition, 


there are four appendices which supplement the text. 


vii 


SECTION 1 
MASTER CONTROL PROGRAM TABLES 


GENERAL. 

An MCP is a modular supervisory computer program which takes over 
repetitive functions, some being logically complex, to make computer 
programmers and operations more productive and efficient. The MCP 
provides the overall coordination and control processing that is 

so important to total production through the maximum use of all 

B 5500 components. Operator intervention is nearly eliminated 
because complete management of the system is assumed by the MCP, 

a comprehensive operating system that provides simultaneous Input / 
Output (1/0) operations and multiprocessing. By controlling the 
sequence of processing, initiating all I/O operations, and pro- 
viding automatic handling procedures to meet virtually all pro- 
cessing conditions, the MCP can obtain maximum use of the system 
components at all times. Since so many functions are performed 
under this centralized control, changes in schedule, system config- 
uration, and program sizes can be readily accommodated. Thus, 


greater overall production and efficiency is achieved. 


All versions of MCP handle the primary functions of control pro- 
grams: loading, interrupts, I/O control, selection and initiation 
of program 1/0 error conditions, system log, storage allocation, 
overlay, and multiprogramming. The MCP is composed of tables 
(i.e., arrays) and of procedures with an outer block which coor- 
dinates their operation. Section 1 focuses on the tables which 


compose the MCP. 


PROGRAM REFERENCE TABLE (PRT) FOR THE MCP. 


The PRT contains the locations reserved for variables, data de- 
scriptors, and program descriptors which give information about 
data arrays and other program information. These locations are 
likely to change in future MCP's. Brackets [] indicate a 


descriptor. Otherwise, the variable is an operand. 


Word 


RRRMECH 
[ SLATE] 


NSLATE 


LSLATE 


AVAIL 


MSTART 


MEND 


TOGLE 


[ BED | 


P1IMTIX 


P2MIX 


DATE 


CLOCK 


XCLOCK 


Contents 
Mask word used by STATUS to check I/O devices. 
Descriptor pointing to SLATE array. 


Pointer to last entry which was started 


from SLATE. 
Pointer to last entry placed in the SLATE. 


Contains the address of the stopper for 
available storage links; its value is the 


highest available address -l. 


Contains the address of the first area of 
storage after the end of the MCP SAVE Pro- 


cedures and the outer block code. 
Pointer to last storage link in memory. 


Word containing the following mask bits: 

HP2T0G, STATUSBIT, SHEETFREE, STACKUSE, STOREDY, 
USERS PACEREADY, HOLDFREE, NSECONDREADY, ABORT- 
ABLE, BUMPTUTIME, KEYBOARDREADY, NOBACKTALK, 
QTRDY, INTFREE, SPOENDULLOG, REMOTELOGFREE. 


Descriptor pointing to BED array. 


Mix index of normal state job for which work 
is being done by Processor 1 in either normal 


or control state. 


Mix index of the normal state job for 
which work is being done by Processor 


2 in normal state. 
Contains current date (YYDDD -- BCL). 


Contains the number of time interval interrupts 
processed since Halt/Load (H/L) multiplied 
by 64. 


External clock which is set by system operator 
and tells the time of day (maintained in 60ths 


of a second). 


Word 


READY 


[ PRT | 


[ JAR | 


[ INTRNSC | 


INTSIZE 


[ INTABLE | 
[ SHEET | 


J OBNUM 


[ PRYOR | 


NOPROCESSTOG 
[NFO] 
[ ISTACK | 


[ PROCTIME ] 


[ LOTIME | 


[ CHANNEL | 


[ FINALQUE] 


[ LOCATQUE | 


Contents 


Contains the contents of the ready register 


on the last read. 
Descriptor pointing to PRT array. 


Descriptor pointing to Jobs Actually Running 
(JAR) array. 


Descriptor pointing to the INTRNSC array. 


Used to determine row size for each mix index 


in INTABLE. 
Descriptor pointing to the INTABLE array. 
Descriptor pointing to SHEET array. 


Pointer to the last entry in the BED. The 
number of entries in the BED is equal to 
JOBNUM (in decimal) DIV 2 +1. 


Descriptor pointing to the PRYOR array, which 
is a table containing priorities for each 


mix index. 

<O if normal state processing is allowed. 
Descriptor pointing to the NFO array. 
Descriptor pointing to the independent stack. 


Descriptor pointing to the PROCTIME array. 
PROCTIME[ 1] contains processor time for job 


with mix index = l. 


Descriptor pointing to the IOTIME array. JIOTIME 
[1] contains I/O time for job with mix index 
ms 


Descriptor pointing to the CHANNEL array. 
CHANNEL[ 1] contains logical unit of last 


descriptor sent out on channel 1. 
Descriptor pointing to the FINALQUE array. 


Descriptor pointing to the LOCATQUE array. 


Word 
TLOQUEAVAIL 
[ LOQUE] 
[ UNIT] 
[ TINU | 


[ WAITQUE | 


NEXTWAIT 


FIRSTWAIT 


[ LABELTABLE] 
[ MULTITABLE] 
[ RDCTABLE | 
[ PRNTABLE] 


ILL 


INQCT 


PINGO 


READQ 


RRNCOUNT 


[ TRANSACTION] 


LEFTOFF 


MESSAGEHOLDER 


BYPASS 


1-4 


Contents 

Pointer to the first available space in IOQUE. 
Descriptor pointing to the IOQUE array. 
Descriptor pointing to the UNIT array. 
Descriptor pointing to the TINU array. 


A QUEUE of units for which there are 1/0 
requests but no I/O channel is available. 


Pointer into WAITQUE at next available slot. 


Pointer at next unit to be used when a channel 


becomes available. 

Descriptor pointing to the LABELTABLE array. 
Descriptor pointing to the MULTITABLE array. 
Descriptor pointing to the RDCTABLE array. 
Descriptor pointing to the PRNTABLE array. 


The head of the queue through which all data 


communication output passes, 


Counter of unprocessed data communications 


interrupts. 


Used to link tanked MCP input messages 
together. 


The head of the queue of all "sought" 


terminal/buffers. 


Count of Read-Ready-Normal data communications 
interrupts. 


Descriptor pointing to the TRANSACTION array. 
Used by OLAY for overlaying core. 


Used by SPOUT and MESSAGEWRITER to link SPO 


messages. 


Used by ENTERUSERFILE to locate the ends of the 
regular and bypass directories. 


Word 


NEXTSLOT 


DISKBOTTOM 


[ DBARRAY | 


DBADR 


DIRECTORYFREE 


TOMASK 


SAVEWORD 


CORE 


KEYBOARDCOUNTER 


NUMESS 


Contents 


Variable used to indicate the next available 


position for file entry in the disk directory. 


Variable set to the highest address of the 


directory. 


Descriptor pointing to the DBARRAY. The array 
used with the DB feature of the DEBUGGING 


option. 

Variable used to contain the disk address 
for the DB feature. 

Variable used to interlock the directory. 


Variable used as a mask to sleep until the 


complete I/O action is finished. 


Used to indicate which "in-use" device is to 


be saved. 


Used by SELECTRUN to determine if a job should 
be introduced into the mix. 


Count of unprocessed keyboard requests. 


Initialized to -100; counts +l for each SPOUT 
message waiting to go to the SPO. 


' STATIONMESSAGEHOLDER 


[ STATION | 
[Fs] 
TUMAX 

[ ATTACHED | 
[ USERCODE ] 


LOOKQ 


Beginning of link-list of messages waiting to 


go to remotes. 

Descriptor pointing to the STATION array. 
Descriptor pointing to the FS array. 
Number of columns in the STATION array. 


Descriptor pointing to the ATTACHED array. 


“Descriptor pointing to the USERCODE array. 


Used to link user codes, masks, and times for 


‘remotes. 


Word 
[ UNITCODE] 


MCP 


MIXMASK 


INFOMASK1 
INFOMASK2 


CCMASK1 
CCMASK2 


OPTION 


[ USERDISK ] 


Contents 


Descriptor pointing to the UNITCODE array. 


Variable containing the user identification 


of the privileged user. 


OPTION WORD. 
Word stored in MCP PRT to set and reset options. The OPTION word 

is also stored as the first word in DIRECTORYTOP. The OPTION word 
can be set or reset via the COLD START Routine or via the keyboard. 


Option 
USEDRA 
USEDRB 
BOJMESS 
EOJMESS 
OPNMESS 
TERMGO 
GIVEDATE 
GIVETIME 
SAMEBREAKTA PE 
AUTOPRINT 
CLEARWRS 


‘DISCONDC or 


NOTIFYOP 
COPNMESS 
CLOSEMESS 
None 
RETMSG 


from remote stations. 


Field 


[47:1] 
[46:1] 
[45:1] 
[44:1] 
[43:1] 
[42:1] 
[41:1] 
[40:1] 
[39:1] 
[38:1] 
[37:1] 
[36:1] 


[35:1] 
[34:1] 
[33:1] 
[32:1] 


Mask for legal input mix messages from remotes. 


Masks for legal input (from remotes) keyboard 


messages not requiring a mix index. 


Masks for legal control card reserved words 


Contains the OPTION word. 


Descriptor pointing to the USERDISK array. 


Keyboard Mnemonic 


DRA 

DRB 

BOJ 

EOJ 

OPEN 
TERMNATE 
DATE 
TIME 
ONEBREAK 
AUTOPRNT 
CLEARWRS 
DISCONDC 


COMPLFILE 
CLOSE 
ERRORMSG 
RET 


Option Field Keyboard Mnemonic 
LIBMSG [32:1] LIBMSG 

SCHEDMSG [30:1] SCHEDMSG 

SECMSG [29:1] SECMSG 

DSKTOG [28:1] DSKTOG 

RELTOG (27 =| RELTOG 

PBDREL [26:1] PBDREL 

CHECKLINK [2531] CHECK 

DSKMSG [24:1] DISKMSG 

DKLOG [23:1] DISKLOG (TSS only) 
LIBERR [22:1] LIBERR (TSS only) 
USEPBD [ 234] - PBDONLY 

SVPBT [ 20:1] SAVEPBT 

MOD310S [2:1] (Cannot be accessed 


through keyboard. ) 


ARRAY INFORMATION TABLE (AIT). 


One AIT is associated with each program. 


WORD O 


POINTER (i.e., INDEX) TO LAST 
CURRENT AIT ENTRY 


Field Contents 
[O:9]| 0 
[19:39] Index to last current AIT entry. 


(INTEGER). 


REMAINING. WORDS 


BLOCK 
COUNTER 


O01 23 8 18 33 ey, 


ABSOLUTE PRT ADDRESS OF 
ARRAY DESCRIPTOR OR 
FILE DESCRIPTOR 


Field Contents 


[0:1] Flag bit. 
[1:2] O = array. 
1 = run time error entry. 
2 = file. 
[3:5] Number of dimensions. 
[ 8:10] Block counter (i.e., nesting depth when file or 


array is declared). 


[18:15] Absolute address of file or array descriptor or of 


Run Time Errors* (RTE) cell containing label word. 


[33:15] Save indicator (1=SAVE) for arrays or for RTE. 


LABEL WORD 
The operand constructed by GOTOSOLVER. 


Field Contents 

[cr] R-relative address of the label descriptor. 

[FF] Proper F Register setting. If O, then outer block. 
[ 8:10] Block Counter setting. 


The operand is usually contained in the stack or in the PRT (for 


RTE). It is used to represent action labels or formal labels. 


SOTATION TABLE FORMAT. 
The Station Table Format is a Dump debugging aid. It is formatted 


as follows: 


Field Contents 
[0:1] Flag bit (off). 
[1:1] Output in process by STATIONMESSAGEWRITER. 


*Error type: 


1 = integer overflow. 
2 = exponent overflow. 
4 = invalid index. 
8 = divide by zero. 

16 = flag bit. 


[8:1] 
+ Oh} 
*[ 13:1] 


*[ 14:4] 
[18:4] 


[22:1] 
*[ 23:1] 
*[ 24:1] 
*[ 25:1] 
[ 26:1] 
*[ 27:1] 


*[ 28:1] 
[29:1] 
*[ 30:1] 
[52:2] 


[32:1] 


Contents 


SPO Console input request flag (Bit 32 should be 


on also). 
Not used. 


TU index into STATION for next control station. Le 


not a control station, its own index. 
Not used. 
TU address for this word. 


DTCU Translator bypassed: Translate=1, omit trans- 
late=0. (Translation: ASCII to BCL or Baudot to 
BCL. ) 


Buffer address for this word. 


Buffer index into STATION for next control station. 


Tf not a control station, its own index. 

Station busy. 

Adapter sensed "abnormal" condition. 

Read-Ready Buffer. 

Group mark or IFAL ending: Group mark=0, IFAL=1. 
Break. 


Write ready: 1=Write without group mark ending. 


(Additional write required to clear buffer.) O=Group 


mark finish write. 


Input error. 


Write in-process. 


Station not ready. 


Mix messages not desired flag (1=no mix message, 


O=output mix messages. ) 


SPO Console flag. (When this bit is on, all input 
is treated as if it had originated at the SPO.) 


*Indicates hardware-defined fields. 


1-9 


Field 

[33:1] 
[34:1] 
[35:3] 
[38:5] 


[43:1] 
[44:1] 
[45:4] 
[46:1] 
[4721] 


Contents 


Not used. 
Message Delete action required. 


Not used. 


Exclusive user's mix index. (=31 if station is 


a SPO Console) 

Tanked input. 

Tanked MCP input being entered. 
Station assigned to a job. 
Station logged-in. 


Not used. 


SECTION 2 
THE DISK 


GENERAL. 
A disk file or system memory is a prerequisite to the use of the 
MCP. The disk file is used by the MCP as an auxiliary storage 


area. Therefore, it is necessary to be acquainted with its organ- 


ization. 
Disk storage is divided into two categories: system disk and user 
disk. System disk is the disk area reserved for: 


a. The DF MCP program and tables. 
b. The disk directory. 
c. The available-disk list, and other DF MCP uses. 


User disk is the area used for remaining facilities. Data files, 
scratch files, and library programs, including the B 5500 problem 
oriented compilers, may be stored in the user disk area. This 
section presents that disk information which is applicable to the 
B 5500 MCP Tables. 


DISK LAYOUT. 

An area on disk to be used for a particular file must be explicitly 
reserved for that file. A program must specify the amount of disk 
required for a file. The DF MCP allows a single file to occupy 
from one to twenty separate areas on disk. The number of areas 

and their size is specified by the program that creates the file. 
The fact that a file is stored in more than one area does not in 
any way affect the way it is referenced by a program. Regardless 
of the number of areas used, a program always addresses a file as 


though it were one continuous string of records. 


The disk layout is dealt with in the following manner: 


DIRECTORY USER 


ESP DIRECTORY 
| — 
O11 2 9223 999 


Y 
 vegment Contents 
O Not used. 
1 Copy of H/L Button Card. 
MCP starts at Storage of operating system. 
segment 2 
ESPDISK Used by the MCP for scratch pad. 
ABORT Location of the Abort Table (Segments 993 
=) 998). 
DIRECTORYTOP Contains parameters for MCP. 
segment 999 on disk. 
Word Field Contents 
O OPTION word. 
1 DATE (in BCL). 
2 Number of electronic storage 
units. 
4 Highest address of directory (Y). 
5 Last number used for control 
deck. 
6 First control deck queued (locat- 


ion in directory). 


Segment 


Contents 


DIRECTORYTOP (cont) 


Word 


7 


10 =) 


15 


Field 


[10]. 


[0:16] 


.[ 16:16] 
s(32¢L6) 


[11].[0:16] 


AGS AG | 
(32216) 


[12 |. [08 164 


.[ 16:16] 
.[ 32:16] 


[13].[0:16] 


.[ 16:16] 
.[ 32:16] 


[14]. 


[0:16] 


sf 16216 | 
.( 32:16] 


[15]. 


[0:16] 


«| £6732] 


Contents 


Last control deck queued (Locat- 


ion in directory). 


Next number available for printer 


backup disk. 


Multiprocessing core factor. 


Specify which data communications 


stations are similar to the SPO. 


Not used. 
TU 1, buffers 


TU 


TU 
TU 
TU 


TU 
TU 
TU 


TU 
TU 
TU 


TU 
TU 
TU 


TU 


ay 


3+ 
4, 
5 


15; 


buffers 


buffers O 


buffers 


buffers O 


buffers 
buffers 


buffers O 


buffers O 


buffers 
buffers 


buffers 
buffers 
buffers 


buffers 


Not used. 


Entries are made in words 10 =) 


15 by the procedure MARKSPOSTA. 


2-3 


segment Contents 
DIRECTORYTOP (cont) 
Word Field Contents 
The Boolean variable HOLDFREE 


is used to interlock the DTI- 


RECTORYTOP. 

16 Q value for data communications 
input. 

17 =) 28 Reserved for expansion. 

29 Contains USERDISKSL during re- 


starts and breakouts. 


DIRECTORY Area used by MCP to maintain di- 


rectory of entire in-use disk. 


USER Area used for storage of system 
log, compilers, and all other 


user files. 


DISK DIRECTORY. 

The MCP maintains, on disk, a disk directory which provides infor- 
mation about all permanent files on the disk. Each directory sec- 
tion is composed of 16 segments which contain information for up 
to 15 files. These sections are allocated as needed in the disk 


directory area specified by the user. 


The 16th segment in a section contains the names (i.e., file iden- 
tification) of each file defined in that section. In the first 
name position, @114 indicates last entry, and @14 means available 


entry. The preceding 15 segments are referred to as file headers. 


NAME 


FILE HEADERS SEGMENT 


1003 1017 1018 


2-4 


NAME SEGMENT 


Contains up to 15 pairs of 


section. 


The names are in 


ceding 15 segments. 


FILE HEADERS 


Word 


O 


*Effective with Mark VIII, 


June 21, 


Field 


[0:15] 
[15:15] 
[30:12] 
[42:6] 


eee 
Leo] 
reels 
[30:18] 
[1:1] 
[2:7] 
[9:1] 
f20s2] 
[11:25] 


[ 36:6] 


1968. 


names for each file defined in this 
the same order as the files in the pre- 


are two words for each file header. 


Contents 


Record length. 
Block length. 
Records per block. 
Segments per block. 


Row length in segments. 
File creator or user code. 


= O Free file. 
> O Public file, sole user file, 
private file. 


< O Security file. 


If 1, then file is new format.* 
Save factor (binary). 
Date of last access (binary). 


Creation date (binary). 


= 1 if file interlock. 

Used by library maintenance. 

Tf 1, then file is new format. 

If 1, then file is a program. 
Reserved for expansion - bits set 
to zero. 

File type (used by Time Sharing System). 


= O, Unknown 


= 1, BASIC 
= 2, ALGOL 
= 3, COBOL 


change 41, page 3, Systems Note No. 229, 


25) 


Word Field 


4 (cont) 
[42:6] 
5 [1:1] 
[1:48] 
6 [6:42] 
7 
8 
9 


10 through 29 


Contents 


= 4, FORTRAN 

= 5, TSPOL 

= 6, XALGOL 

= 7, SEQ 

= 8, DATA 

= 9, LOCK (Security). 


Open count. 


= 1, PRIVATE file. 
= 0, SOLE user file or SECURITY file (see 
H[2].[1:1]). 
12, INFO file if H[6] = 12, ana H[2] # o; 
PUBLIC file if H[6] = 0 and H[2] = 0; 
FREE file if H[6] = 12 and H[2] = 0. 


File ID if SECURITY file (see H[2] ana 


H[5]). 
Number of logical records (EOF pointer). 


Number of segments per row, as specified in 


file declaration. 


Number of rows, as specified in file 


declaration. 


Binary disk addresses of rows (zero if not 


assigned). 


The layout of the disk below the directory is presented in figure 
2-1. 


O 

DISK NOT USED 

ADDR 
1 H/L BUTTON CARD 
2 


INTERRUPT CODES 
MCP'S 
PRT 


OUTER BLOCK CODE 


SAVE CODE 


NON-SAVE CODE 


ESPDISK 
(MCP SCRATCH PAD AREA) 


MCP DIRECTORY TOP 
AND DIRECTORY 


DIRECTORYTOP (999) 


DISKTOP 


Figure 2-1. Layout of Disk Below the Directory 


The MCP scratch pad area begins at the first segment beyond the 
last segment used for non-save code. Initially, ESPDISKAVAIL is 
set = 0, and DISKTOP is set to the address of the first usable 
segment in the scratch pad area. DISKTOP will contain the address 
of the first usable segment in the contiguous scratch pad area. 

If DISKTOP + 1 ever becomes equal to the address of DIRECTORYTOP, 


then a PUNT message of NO MCP DISK will be initiated and the system 
will halt. 


NOTE 
GETESPDISK will return the address 
of an available segment in the MCP 


scratch area as an operand. 


FORGETESPDISK (segment address) will 
return the address specified by "seg- 
ment address", which must be an operand, 


to an available scratch area. 


DALOC. 


DALOC is a two dimensional array used to manage overlay storage 
both on drums and disk. It has MIXMAX +1 rows, each of which is 


initially nine words long, and is expandable as required. 


DALOC INX PIMIX points to the DALOC Row for PIMIX which has the 


following construction: 


WORD O 


WORD 1 


DISK ADDRESS 


(<O IF DRUM) 


WORD 2 
O 9 12 18 24 30 36 N42 47 
NOTE 
Words 3 and 4, 5 and 6, 7 and 8, etc. 
are identical in construction and use 
to words 1 and 2. 

Word O Field Contents 

INDEX [18:15] Pointer to the first evenly numbered 
word (2, 4, 6, etc.) which may be used 
to locate some overlay storage. 

LIMIT [33215] Pointer to the last (largest) evenly 
numbered word which is being used for 
this PIMIX. 

Word 1 


Contains the disk address of the base of a 500 segment section of 
overlay storage. One such section is made available at SELECT RUN 
time. If this word is negative, the overlay storage referenced is 


on the drum. 


Word 2 Field Contents 


[ 2:7] Contains the next relative address 
available within the sub-section indi- 


cated by the following field (9:3). 


[ 9:3] . Indicates which of the following sub- 
sections (100 segments each) is active 
(O through 4). 


[ 18:6] Sub-section number 1, 
[ 24:6] Sub-section number 2, 
[ 30:6] Sub-section number 3, 
[ 36:6] Sub-section number 4, 
[ 42:6] Sub-section number 5, 


Each sub-section controls 100 segments 
of overlay storage. The number in each 
field indicates the number of times the 
system has allocated space from the 


applicable 100 segments of a sub-section. 


When an area referenced by a descriptor has been overlaid, bits 33:6 
of the descriptor contain a value used to locate the odd-numbered 
word in the DALOC Row for this mix index, which contains the base 
disk address of the 500 segment section in which the information 
has been placed. Bits 39:9 of the descriptor contain the offset, 
which, when added to the base, gives the absolute disk address of 


the information. 


When a previously overlaid area is made present again, these two 
fields are transferred to the F field of the descriptor. This 
will assure that subsequent overlays of this data will return to 


the same place on disk. 


If we say DESC is defined as the descriptor, then the disk address to 
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which we must re-overlay is calculated as 
DALOC[ PIMIX, DESC. [33:6]x2-1]+DESC.[ 39:9] 


AVATLABLE-DISK TABLE. 
The Available-Disk Table is a two part, Fine/Coarse Table. While 
the Fine Table is maintained on disk in ESPDISK, the Coarse Table 


is kept in core memory. 


The format of the Fine Table in ESPDISK is as follows: 


WORD 29 


WORD 2 


WORD 1 


DKSZ DISKA 


0: <3 24 K'7 


WORD O 


NUMBER OF VALID ENTRIES IN 
THIS 30 WORD TABLE (1-29) 


The format of the Coarse Table in core memory is as follows: 


WORD O = 


ESAD UNUM 


WORD 1 


DKSZ DISKA 


O 3 24 M7 


The Coarse Table is expandable in two word increments, as additional 


Fine Table entries are required. 


Word Field Contents 
DISKA [23225 | Absolute disk address of a section 


of available disk. 


DKSZ [3:20 | Size of the available area starting 
at DISKA. 


In the Coarse Table, there are copies of the entry for the largest 


area in the associated Fine Table. 


ESAD [1215 | Address of the associated Fine Table 
in ESPDISK. 


UNUM [hee 5-] Number of valid entries in the Fine 
Table. UNUM must agree with word O 
of the Fine Table. 


SECTION 3 
MCP CLASSIFICATION AND ORGANIZATION OF CORE STORAGE 


GENERAL. 
Certainly, if core storage is to be put to use efficiently, it must 
be classified and organized. Basically, storage is organized 


through the use of memory links. 


The MCP classifies core areas containing information which must 
remain in place as non-overlayable storage. for example, the MCP 
has routines and tables that must frequently be used when handling 
interrupt conditions and other control functions. The space that 
would be momentarily gained by overlaying such information would 
not be worth the time required to make the information present when 


needed again. 


There is also a need for certain kinds of object program information 
to remain in fixed locations while a program is being processed. 
This requirement holds for all information which will be referenced 
by the MCP through the use of absolute addresses; for example, 


control fields which contain absolute addresses of program segments. 


Overlayable storage refers to information in core storage that 
must be present when needed. Tt is often the case that all infor- 
mation pertaining to a program cannot be in core at the same time. 
This is most often the case when programming for operating systems 
with less than maximum core. However, the majority of the infor- 
mation related to object programs, and most information in the 
MCP, may be used relatively infrequently. With respect to such 
information, the major factor determining its necessity to be pre- 


sent in core is that it must be present when needed. 


Since the B 5500 programs are stored on disk during the time they 
are processing, individual program segments are read into core as 
they are needed. If the area used by the program segment is to be 
overlaid, there is an exact copy of it on disk. The MCP has only 


to mark the segment absent in appropriate places, and the area it 


occupied can be used for other segments. If the segment is needed 


again, it can be read into core from disk. 


Available storage is storage currently not in use. Such storage 
can be assigned as needed. Section 3 deals with the memory links 


which are used by the MCP. 


MEMORY LINKS. 

Memory links are used by the MCP to keep track of the assignment 
of core areas. There is an available memory link in every unas- 
signed area. A memory link for available storage occupies three 


words. These words provide the following information: 


a. They specify that the area is available. 
b. They specify the size of the area. 


c. They provide the address of the following available area. 


When core storage is classified and organized for the first time 
after a H/L, the MCP performs operations to determine what memory 
modules are available on the system in a contiguous area from mem- 
ory address 0. Links are set up so that the areas in those modules 
which are not present are never assigned, and, consequently, never 
addressed. Permanent MCP program segments related to initialization 
routines may be in core after initialization, but they are over- 


layable; all other core is marked available. 


Figures 3-1, 3-2, and 3-3 present information necessary to 


deal successfully with memory links. 


WORD 1 


ADDRESS OF ADDRESS OF 
PREVIOUS AREA NEXT AREA 


Field Field Value Contents 

[O:1] O Flag bit. 

[1:1] 1 | Availability. 

t2¢3:4 NA* 

[3:6] NA 

[9:6] NA 

[15:3] NA 

[18:15] Address Address of first word of link 


for previous area. 


[33:15] Address Address of first word of link 


for next area. 


¥NA=Not Applicable 


Figure 3-1. Links for Available Area (3 Words) Field 
Values and Contents (Sheet 1 of 2) 


WORD 2 


ADDRESS 
OF NEXT 
AVATLABLE 
AREA 


SIZE OF 
THIS AREA 


0 18 33 47 
Field Field Value Contents 
[0:18] O Zeros required by LLL operator. 
[18:15] Varies Size of available area. 
[33:15] Address Address of second word in link 


for next available area. 


WORD 3 
ADDRESS OF 
PREVIOUS 
AVAILABLE 
AREA 
O 33 47 
Field - Field Value Contents 
[0:33] O None. 
[33:15] Address . Address of second word in link 


for previous available area. 


Figure 3-1. Links for Available Area (3 Words) Field 
Values and Contents (Sheet 2 0f 2 


3-4 


WORD 1 


ADDRESS ADDRESS 
OF OF 
PREVIOUS NEXT 


AREA AREA 


Field Field Value Contents 
[o:1] ) Flag bit. 
[1:1] O Availability. 
[2:1] 0/1 Save (1 = save area). 
[3:6] 0-7 Type of area: 
O = miscellaneous data. 
Ll = program. 
2 = data. 
3 = I/O buffers. 
4 = ALGOL FIB. 
5 = MCP data communications area. 
6 = COBOL FIB. 
7 = intrinsic segment. 


[9:6] O - MIXMAX Mix index of program using area. 
Intrinsics and MCP always have MIX 
field = O. Re-entrant program code 


has the mix of the first job. 


[15:3] NA None. 


Figure 3-2. Link for In-Use Area (2 Words) Field 
Values and Contents (Sheet 1 of 2) 


Field Field Value 


[18:15] Address 
[33:15] Address 
WORD 2 


5 av PRE RE ENS TS TES, (Case. 


Oo 1 
Field Field Value 
[0:33] Varies 
[33:15] Address 


Contents 


Address of first word of link for 


previous area. 


Address of first word for next area. 


ADDR 


33 47 


Contents 


Type 2 data-overlay address 
on disk. 
Size of program segments and 


intrinsics. 


If data or file tank, address of 
array descriptor. 

If object program, segment number. 
If it is a data communications' 
buffer area, READQ or ILL link word. 
If MCP program segment, PRT address. 
If intrinsic, segment number for 


the job which first made it present. 


Figure 3-2. Link for In-Use Area (2 Words) Field 
Values and Contents (Sheet 2 of 2) 
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SECTION 4 
LOGGING 


GENERAL. 

MCP maintains a computer log recording the system time and other 
information concerning the program. The maintenance of the log is 
performed automatically by the MCP. Records are written on the 

log file in the order in which the information becomes available. 
The log information is written in a file on user disk called SYSTEM/ 
LOG. 


The first record in the log is used by the MCP. The value of the 
first field in this record specifies the number of records written 
in the log. The value of the second field specifies the record 
capacity of the log. The third and fourth fields are used in con- 
junction with the warning messages supplied by the MCP which specify 
when the log is half full or full. The fifth field contains the 
word "DSKLOG." 


The MCP writes several types of records for every job. These are: 


a. BOJ and EOJ records. 
b. File records. 


c. Idle time and H/L records. 


A program to print the log is provided. However, any program can 
read the log file. Consequently, each installation can provide 
its own log printing program, and format the output as desired. 
Section 4 is a detailed presentation of the logging procedures and 


formats for the B 5500 Systems. 


ABORT TABLE. 

The Abort Table is kept by the MCP to log-off abort jobs. It is 
used by NSECOND in termination. The Table is located at 
DIRECTORYTOP - 6. 


Word Contents 


O . XCLOCK 


Word Contents 


1 DATE 
2 "ABORT" 
The next three entries are repeated for each job in the mix. If 


the mix number is not assigned, the entries are zeroed. 


Relative Location Contents 
3xmMrx Process time, 
3xMIX + 1 T/O time. 
3xMIX + 2 IDLETIME (from the JAR). 
3xMIX + 90 First name of object program. 
3xMIK + 91 Second name of object program. 
3xMIX + 92 [1:23] start time, and [24:24] pointer 


to location of control card in ES PDISK 
to be written into the SYSTEM/LOG. 


FORMAT OF THE SYSTEM/LOG. 


A program to print the log is provided by Burroughs Corporation. 
However, any program can read the log file. Consequently, each 
installation can provide its own log printing program, and format 


the output as desired. 


SYSTEM/LOG SPECIFICATIONS. 

Log information for programs run on a B 5500 System is written in 
a file on user disk. The log file occupies one area on disk, and 
has the (file identification prefix) SYSTEM and the (file identifi- 


cation) LOG. It is the user's responsibility to provide this file. 


The file SYSTEM/LOG is blocked. There are six logical records per 
Physical record. The logical records are five words (i.e., 40 


characters ) in length; the physical records are 30 words in length. 


1. Mix index. 


42 


LOG ENTRY 


Entries 


gories: 


SPECIFICATIONS. 


n the log can be considered to fall into one of four cate- 


Compile-and-Go entries, 
Compile-Only entries, 
Execute entries, and 


Disk log entries. 


With respect to these categories, the following rules determine how 


a program is entered in the log. 


If a Compile-and-Go run is made and the program being com- 
piled contains no syntax errors, the log information for 
both the compiler and the object program is listed in a Com- 


pile-and-Go entry. 


If a Compile-and-Go run is made and the program being com- 
piled contains syntax errors, or ifa Compile-for-Syntax 
run is made, or if a Compile-to-Library is made, the log 
information for the compiler is listed ina Compile-Only 


entry. 


Tf an Execute run (i.e., library call-out) is made, the log 
information for the object program is listed in an Execute 


entry. 


If the DISKLOG compile time option for the MCP is set, disk 
files will be logged at the time the files are removed from 
the disk (e.g.; after a CC REMOVE ) under the following con- 


ditions: 
1) When a scratch file is CLOSEd. 
2) When a file is CLOSEd after obtaining more space. 


3) When a file is LOADed from a library tape with the same 
(multi-file identification) / (file identification) as 


a file on disk. 


4) When the operator enters a log-out istruction, LNDK. 
The LNDK message logs out all disk files and resets 
their creation date (H[3].[30:18]) and the creation 
time (H[1].[25:23]). 


Figures 4-1 and 4-2 present the disk file and the general format 
for log entries. The first log entry starts in the record with 


relative address 1. 


CREA- CREA~- DATE TIME NUMBER 
TION TION OF 
TIME TIME LOGGED | LOGGED |ISEGMENTS 


WORD 1 WORD 2 WORD 3 WORD 4 WORD 5 |WORD 6 WORD 7 WORD 8 WORD 9 WORD 10 


1 RECORD 


1 RECORD 


Entry Description 

Type Code =8 

MFID First Name of File (7 CHR) 
FID Second Name of File (7 CHR ) 
User Code (7 CHR) 

Creation Date In Form YYDDD (BCD) 
Creation Time 1/60 Second (ocT) 

Date Logged In Form YYDDD (BCD) 

Time Logged 1/60 Second (ocT) 

Number of Segments (ocT) 

O Reserved for Expansion 


Figure 4-1, Disk File Log Entry 


ho 


COMPILE-AND-GO ENTRY 


CONTROL CARD OBJECT PROGRAM 
INFORMATION COME PERE ON per INFORMATION 


SS Sane, 


GENERAL ' 


PROGRAM IE 
INFOR- * 


“itn 


2 RECORDS 2 RECORDS RECORDS 2 RECORDS JIM RECORDS 
(CODE = 3) (CODE = 1 OR 2) (CODE = 0) 
COMPILE-ONLY ENTRY 


CONTROL CARD 
INFORMATION COMPILER INFORMATION 


2 RECORDS 2 RECORDS RECORDS 
(CODE = 3) (CODE = 1 OR 2) 


EXECUTE ENTRY 
CONTROL CARD OBJECT PROGRAM 
INFORMATION INFORMATION 


GENERAL 
PROGRAM 


INF OR- 


2 RECORDS 2 RECORDS M RECORDS 
(CODE = 3) (CODE = 0) 


NOTE 
N = Number of files declared by compiler. 
M = Number of files declared by object program. 


Pigure 4-2. General Format of each of the 
Three Types of Log Entries 


CODE WORD. 


As shown in Figure 4-2, each log entry contains: 


ae Control card information, and 


b. Compiler and/or object program information. 


The code word preceding each group of information denotes the type 
of information. Information preceded by a 1 pertains to the ALGOL 
Compiler; information preceded by a 2 pertains to the COBOL Com- 
piler; and information preceded by a O pertains to an object pro- 


gram. Code 4 denotes the end-of-log information. 


CONTROL CARD INFORMATION. 

Control card information is contained in the first two records of 

a log entry, starting at the second word of the first record. This 
information is a copy of the contents of the first 72 columns of the 
COMPILE Card or EXECUTE Card that caused the particular run to be 
scheduled. 


The word immediately preceding the control card information is a 


code with the integer value 3. 


COMPILER AND OBJECT PROGRAM INFORMATION. 
Compiler information and object program information have identical 
formats. Therefore, the format for this information will be dis- 


cussed under the general name "program information". 


Program information falls into two categories: 


a.» General program information, and 
b. File information. 
The general program information is contained in two records. The 


file information requires a variable number of records, depending 
upon the number of files declared by the program. There is one 
record required in the log for each file declared by the program. 


Each record of file information, however, has the same format. 


Figure 4-3 shows the format of general program information. Figure 
4-4 shows the format of one record of file information. 


‘ GENERAL PROGRAM INFORMATION 


NO. OF 
FILES 
DECLARED 


PROCESS | 1/0 
TIME TIME 


Entry Description 


CODE INTEGER: 1 = ALGOL, 2 = COBOL, 3 = obj. prog., 
5 = printer backup, 6 = FORTRAN, 
8 = disk log 
NO. OF FILES 
OPENED INTEGER 
PROCESS TIME INTEGER: Time in 60ths of a second. 
I/O TIME INTEGER: Time in 60ths of a second. 
DATE BCL: YYDDD format* (e.g., 65046). 
START TIME INTEGER: 60ths of a second since H/L time. 
STOP TIME INTEGER: 60ths of a second since H/L time. 
FINISH CODE INTEGER: O = EOJ, 1 = SYNTAX ERROR, 2 = DS-ed. 
REE (Reserved for Expansion). 


¥*The YYDDD format provides that the YY characters specify the last 
two digits of the year, and the DDD characters specify the number 
of the day of the year. 


Figure 4-3. Format of General Program Information 
in a Log Entry, including the Code Word. 


MULTIPLE 


F FILE 
IDENTI- 
FICATION 
WORD 1 
Entry 
MULTIPLE FILE 
IDENTIFICATION 


FILE IDENTIFICATION 


REEL NO. 


DATE 


CYCLE 


NOE (Number of errors 


while handling file) 


UNIT 


LENGTH OF TIME FILE 
WAS OPENED 


RFE 


Figure 4-4. 


IDENTI- 
FICATION 


FILE 


Description 
BCL: 


BCL: 


BCL: 


BCL: 


BCL: 


BINARY: 


BINARY: 


INTEGER: 


Located 


racters 


Located 


racters 


Located 


racters 


Located 


racters 


Located 


ters of 


Located 
of WORD 


Located in seventh character of WORD 4. 


LENGTH OF 
TIME FILE 
WAS OPENED 


in second through eighth cha- 
of WORD 1. 

in second through eighth cha- 
of WORD 2. 

in first through third cha- 
of WORD 3. 

in fourth through eighth cha- 
of WORD 3. 

in first and second charac- 
WORD 4, 

in fifth and sixth characters 
ne 


(See list below for meanings of the 
values of UNIT.) 


Time in 60th of a second. 


(Reserved for expansion. ) 


Format of One File Information Record 


The values of UNIT specify what unit was used by the subject file. 


The values are now defined. 


Value 


O 


Oo An Au FW DY FEF 


= 
oe) 


11 
12 
13 
14 
15 
16 

5 
18 
19 
20 


21 
22 
23 
2h 
25 
26 
at 
28 
29 
30 
31 


I/O Unit 


Not opened 
MTA 
MTB 
MTC 
MTD 
MTE 
MTF 
MTH 
MTJ 
MTK 
MTL 


MTM 
MTN 
MTP 
MTR 
MTS 
MTT 
DRA 
DRB 
DKA 
DKB 


LPA 
LPB 
CPA 


CRA 


CRB 
SPO 
PPA 
PRA 
PPB 
PRB 
DCA 


SPECIAL RECORDS AND LOG INITIALIZATION. 
Additional information concerning log maintenance for the MCP 


includes the following: 


RECORD ZERO. The first record in SYSTEM/LOG (i.e., the record with 
relative address 0) is used by the MCP when making log entries. 


The value of the first word in record zero specifies the number of 
records written in the log. The value of the second word specifies 
the record capacity of the log. The third and fotirth words are 
used in conjunction with the warning messages supplied by the MCP 
which signify when the log is half-full and full. The fifth word 
contains, in BCL, "DISKLOG", 


RECORD N + 1. The first word of the record immediately following 
the last log entry contains a code with the value 4. This record 
denotes the end-of-log information, and it is not included in the 


value contained in the first word record of record zero. 


INITIALIZING THE LOG. If a user program wishes to initialize the 
log (tc set up the log so that the MCP considers the log empty), 


the following actions are performed: 


ae The first, third, and fourth words in record zero 


must be set to zero. 


b. The first word in record 1 must be set to 4, 


FORMAT OF ‘THE REMOTE/LOG. 


The topic of formatting the Remote Log is dealt with by giving the 

necessary specifications for the log. The log entry specifications 
are presented as six types. In addition, the two part partition 

of the file REMOTE/LOG is discussed with the file maintenance pro- 


cedures and with the WR keyboard input message. 


REMOTE LOG SPECIFICATIONS. 
The remote log information for the data communications! facilities 
is written in a file on the user disk. The file has the (file 


identification prefix) REMOTE and the (file identification) LOG. 
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The file REMOTE/LOG is blocked and is confined to one area on the 
disk. There are five logical records per physical record. A logi- 
cal record is five words in length or 40 characters; a physical 
record is 30 words in length. It is the user's responsibility 

to provide this file. Logging for data communications is bypassed 


if the system does not provide a REMOTE/LOG file. 


LOG ENTRY SPECIFICATIONS. 


Entries in the Remote Log are of six types: 


Type 1 Log-out entry. 

Type 2 Log-in entry. 

Type 3 Control card entry of less than 32 characters. 
Type 4 Control card entry of 32 characters or more, but 


not greater than 72 characters. 
Type 5 Job statistics entry. 
Type 6 Abort information entry. 


Types 1, 2, and 3 each require one logical record in the log. 


Types 4, 5, and 6 require two logical records per entry. 


TYPE 1 LOG-OUT ENTRY. 
The following information is entered into the file REMOTE/LOG when 


a data communications' station logs out. 


Word O 9:9 Station number ([9:4]=TU,[14:4]=BUF). 
[42:6] Code = l. 


Word 1 User identification (as specified by the 


1 Record File Security System). 


Word 2 Current date (YYDDD-BCL). 


Word 4 Unused. 


TYPE 2 LOG-IN ENTRY. 
The MCP enters the following information in the file REMOTE/LOG 


when a data communications' station logs in. 


Word O [9:9] Station number ([9:4]=TU,[14:4]=BUF). 
L4226| “Gode-= 2. 


Word 1 User identification (as specified by the 
File Security System). 
1 Record 


Word 2 Current date (YYDDD-BCL). 
Word 3 Time of day at log-in. 
Word 4 Unused. 


TYPE 3 CONTROL CARD ENTRY (31 CHARACTERS OR LESS). 

The MCP enters the following information (or type 4 information) 
in the file REMOTE/LOG when a job is selected to run. Every RUN 
or EXECUTE from a remote station is logged. 


Word O [9:9] Station number ([9:4]=TU,[14:4]=BUF). 
[18:24] RUN NUMBER*. 
[42:6] -Gode = 4. 
1 Record 


Word 1 
through Contents of control card. 
Word 4 


TYPE 4 CONTROL CARD ENTRY (32 CHARACTERS AND UP TO 72 CHARACTERS ). 
The MCP enters the following information (or type 3 information) 
in the file REMOTE/LOG when a job is selected to run. Every RUN 
or EXECUTE from a remote station is logged. 


Word O [9:9] Station number ([9:4]=TU,[14:4]=BUF). 
[18:24] RUN NUMBER*. 
[42:6] Code = 4. 
2 Records 
Word 1 
through Contents of control card. 
Word 9 


*Entries in the file REMOTE/LOG corresponding to entries in the file 
SYSTEM/LOG have the same RUN NUMBER, where a job's RUN NUMBER is de- 
fined to be its start time (in 60ths of a second) as specified in 
the System Log. 
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TYPE 5 JOB STATISTICS. 


The MCP enters the following information in the file REMOTE/LOG 


when a station detaches from a job. 


Word Field 

©) Leta] 
[9:9] 
[18:24] 
[42:6] 

1 

2 

3 

im 

5 

6 

7 [3:21] 


Contents 


1 if this station attached by entering 
an EXECUTE or RUN card; O if attached 


by READ, SEEK or WRITE. 


Station number ([9:4]=TU, [14:4]=BUF). 


RUN NUMBER (as specified in the types 


3 or 4 entries). 
Code = 5. 
User code. 


First name of the object program 


(seven characters). 


Second name of the object program 


(seven characters). 


Processor time in 60th of a second; 
i.s.e., processor time used for this 


station, out of total used by job. 


Pro-rated time in 60th of a second; 
i.e., pro-rated time used by this 


station, out of total used by job. 


I/O time in 60th of a second; 
i.e., I/O time used by this station, 
out of total used by job. 


Start date; i.e., date when job 


attached to this station (in binary) 


Word Field Contents 
7 (cont) [27:21] Stop date; i.e., date when job detached 


from station (in binary). 


8 Attach time; i.e., time when job 


attached to station. 


9 Detach time; i.e., time when job 


detached from station. 


TYPE 6 ABORT INFORMATION ENTRY. 
The form of a type 6 entry is: 


Word Field Contents 
O (2eL4 1 if this station attached by entering 


an EXECUTE or RUN Card; O if attached 
by READ, SEEK or WRITE. 


[9:9] Station number ([9:4]=TU, [14:4]=BUF). 
[18:24] Run number. 
[42:6] Code = 6. 

1 User code. 

a First name of object program. 

3 Second name of object program. 

4 Processor time in 60ths of a second; 


i.e., processor time used by this station 


out of total used by job. 


5 Pro-rated time in 60ths of a second; 
i.e., pro-rated time used by this station 


out of total used by job. 


6 I/O time in 60ths of a second; i.e., 1/0 
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Word Field Contents 


6 (cont) time used by this station out of total 
used by job. 


7 [3:21] Start date; i.e., date when job attached 


to this station (in binary). 


[27228] Stop date; i.e., date of last H/L 


(in binary). 


8 Attach time; i.e., time when job 


attached to station. 
9 Detach time; i.e., time at last H/L. 


CREATION OF REMOTE LOG ENTRIES. 
As indicated above, log-in, log-out, and control card entries are 
made at the time at which they occur. This is possible since the 


information contained in those entries is immediately available. 


The information contained within a job statistics’ entry is accumu- 
lated during the time that a remote terminal is attached to a pro- 
gram. The entry is recorded in the Remote Log at the time a pro- 


gram and remote terminal become detached from one another. 


It is the responsibility of the object program to dictate which 
remote station is to be charged for any particular "slice" of a 
program's processor, I/O, and pro-rated time. The task involved 
in specifying the station to be charged is, however, an easy one. 


The procedure involved in slicing times is as follows. 


The MCP maintains a table, called USERSTA, which contains one l1oca- 
tion for each program in the mix. The contents of a given program's 
location in this table is the station address of the remote station 


presently specified to be charged for the time used by that program. 


When a program enters the mix, its location in the USERSTA Table 
is set to the address of station 0/O, a non-existent remote termi- 


nal. The times assigned to station 0/O are those which the program 
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does not assign to any given station; i.e., they are unassigned 
time. Then from that time until the address in that program's 
USERSTA location changes, station 0/O is Charged for all processor, 
r/o, and pro-rated times charged to the program. When the address 
in the program's USERSTA location changes, the remote terminal 
whose address is then specified begins being charged for the times 


assigned to the program, etc. 


The way in which a program designates the address to be placed in 
USERSTA (G2. the way in which a program designates the station 

to be charged) is to perform either a passive or active interrogate 
statement referencing the station. In ALGOL, this involves a 
statement of the form STATUS (TUBUF,0O) or STATUS (TUBUF,1). In 
COBOL, it involves a statement such as MOVE FILENAME FROM TU, BUF 
TO STATUSWORD or MOVE FILENAME FROM TU, BUF APTER CHECK TO STATUS- 
WORD. Each time such an interrogate is performed, the MCP checks 
to see if the terminal buffer address currently in the program's 
USERSTA location is different from the one specified in the interro- 
gate statement. If it is, the old station is charged with all 
times since the previous change in USERSTA and the new station is 


established as the new recipient of time. 


It should be noted that, if a program wishes to designate certain 
times as being unassigned (i.e., assigned to station 0/0), it 


should perform a passive interrogate on station 0/O. 


Whenever a station is detached from a program, a job statistics 
entry is recorded in the log. The entry, of course, contains all 
the times which were allotted to the station in the manner des- 


Cribed above. 


The file REMOTE/LOG is partitioned in two parts. If n is an integer 
specifying the number of 30 word segments used by the file, then 

the first n-ABRTLNGTH segments are reserved for remote terminal 
log-entries. The record capacity of this area in logical records 

is 6 x (n-ABRTLNGTH). The abort information is written in the 
remaining ABRTLNGTH segments of the file. The parameter ABRTLNGTH 
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(MCP Sequence No. 00908000) specifies the number of segments used 
in maintaining abort information and must not exceed 34. A remote 
terminal requires an entry in the Abort Table for each program to 
which it is attached; the maximum number of entries accommodated 

is 3 x ABRTLNGTH -1. In the event that a H/L is necessary, the 
abort area of the file REMOTE/LOG is checked to determine if any 
remote terminals were attached prior to the H/L sequence. Abort 
information is formatted as a type 6 entry, and placed in the first 


(n-ABRTLNGTH ) segments. 


FILE MAINTENANCE PROCEDURES. 

To retain information for the file REMOTE/LOG, a FILE CARD group 
should appear in the Cold Start Deck (see Burroughs B 5500 Elec- 
tronic Information Processing System Operation Manual, Form 1024916, 
pages 3-9 through R214) 


The first record of the file REMOTE/LOG (i.e., the record with 
relative address 0) describes the remainder of the file. Contents 


of record O are: 


Word O Value of word equals the number of 


logical records written in the file 


REMOTE/LOG. 
Record O Word 1 Value of word equals the record capacity 
File , ‘ ‘ 
REMOTE /LOG (in logical records) of the file REMOTE/ 
LOG. 
Word 2 
through Reserved for system use. 
Word 4 


A user program must initialize word O of the file REMOTE/LOG to O 
and word 1 to the record capacity of the file. For example, if the 
FILE Card in the FILE CARD group of the Cold Start Deck has the 


form 


PILE REMOTE/LOG,1x1000 


eel 7 


then a user program must initialize Record 0, Word O to O and 
Record O, Word 1 to 6000, 


The B 5500 operator is notified when the log is half-full and when 
the log is full. Should the log become full, wrap around will 
occur. If the log is not present, the operator will be notified 


the first time the log is accessed. 
Operator notification is via the SPO and the messages are: 


#REMOTE/LOG FULL 
This message is typed when the log is full. Wrap- 


around will occur the next time the log is accessed. 


##DUMP REMOTE /LOG. 
This message is typed when the log is half-full. 


#NULL REMOTE/LOG 
This message is typed the first time the remote log 


is accessed and is not present. 


THE WR KEYBOARD INPUT MESSAGE. 

If the file with (file identification prefix) REMOTE and (file 
identification) LOG is not on disk and the operator enters a WR 
keyboard input message, then 1000 segments are obtained for the 
file REMOTE/LOG and it is entered in the disk directory. The 
first 1000-ABRTLNGTH segments are reserved for log-entries; the 
record capacity in logical records of this area equals 6 x (1000- 
ABRTLNGTH ) . The remaining segments are reserved for information 
pertinent to remote terminals currently attached to programs for 
abort logging if necessary. An entry is made in this section of 
the file for each remote terminal attached to a job. The maximum 
number of such entries is 3 x (ABRTLNGTH-1). The message 


#REMOTE LOG ON DISK 


is typed out on the SPO when the REMOTE/LOG has been placed on disk 


and initialized. 
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SECTION 5 
I/O CONTROL 


GENERAL. 
The I/O Control functions of the MCP are logically divided into 


two parts: 


a. Processing of I/O requests made by the object program, 


and, 
low Processing of situations resulting from a hardware action; 
i.e., an independent interrupt. 


The first covers opening the files, reading and writing files, with 
special regard to problems offered by the disk files, and closing 
the files. The second describes the processing of 1/0 results, 
hardware errors, and error routines. Section 5 focuses on the 


detailed MCP Table information which is applicable to T/O Control. 


T/0-QUEUE (LOCATQUE, UNIT). 

TOQUE, FINALQUE, and LOCATQUE together with UNIT forms the T/0- 
QUEUE. An I/O request for logical unit U requires three words of 
space in the I/O-QUEUE. If the request occupies position S in the 
I/O-QUEUE, then TOQUE(S) contains the I/O descriptor for the re- 
quest. FINALQUE(S) contains the I/O descriptor skeleton to be used 
at I/O complete time to rebuild the original I/O descriptor. LO- 
CATQUE(S) points to the location of the I/0 descriptor at the time 
of request. The spaces not used in the T/O-QUEUE are linked to- 
gether through IOQUE. The first available entry is pointed to by 
TOQUEAVAIL. 


All entries in LOCATQUE have the following format: 


Word Field Contents 


5 [0:3] Descriptor identification bits. 


MIX INDEX [3:5] MIX INDEX of program which requested 
the I/O operation. 


[ 8s3)] Not used. 
ER [iii] Error retry in process. 
LUN PI2eG| Logical unit number of unit on which 


the I/O is to be executed. 


INDEX [18:15] Index into I/0-QUEUE of next I/O request 
on this unit. @77777 if no additional 


requests occur. 


ADDRESS [33:15] Address of the I/O descriptor used for 
this request at time request was made. 
If buffering is being used by the object 
program, the descriptors are rotated 
and the I/O descriptor may not remain 


in its original location. 


All entries in UNIT have the following format (this is a SAVE 


array): 


ERROR 


VARIES 


BIT 


Word Field Contents 


0 | O@4,) Flag bit. 
Type code [as4] O = card reader. 
1 = line printer. 
2 = magnetic tape. 
3 = drum. 
4 = disk. 
5 = Spo. 
6 = card punch. 
8 = paper tape punch. 
9 = paper tape reader. 
10= data communications. 
Error field [5:8] Error field of last I/O done on this 
unit. 
0/1 (132d Not ready bit O = unit ready. 
1 = unit not ready. 
0/1 [14:1] Error flag bit O = no errors. 
1 = errors. 
0/1 [15:1] Waiting for I/O channel 1 = 1/0 


awaiting an I/O channel. 


Varies [16:2] I/O in process bits 00 = unit not 
in process. 
11 = unit in process. 
O1 = for line printer 


only. I/0 
complete but 


awaiting printer 


finish. 
INDEX [18:15] Index of first I/0 request for which 
service is not complete. @7'7777 if 
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Word Field Contents 


INDEX (cont) none. This is the first entry in the 
QUEUE. 
[33:15] Index of last I/0 request (entry in the 


QUEUE) for which service is not complete. 


INPUT OUTPUT ASSIGNMENT TABLE. 
The I/O Assignment Table is presented as table 5-1. The discussion 
which follows the table focuses on the logical unit numbers for 


each I/O unit. 


LOGICAL UNIT NUMBERS. 

The MCP associates one unique logical unit number with each 1/0 
unit, which is different from the hardware unit number. The logical 
unit numbers assigned the 1/0 units were determined by the format 

of the result of the Read-Ready-Register (RRR) Operator. The re- 
sult of the RRR operation is stored in the field £27291) % Num- 
bering from right to left, bit [47:1] is numbered 0, and bit [22:1] 


is numbered 25. 


Table 5-1 
I/O Assignment Table 


UNIT Besa RRRMECH BIT 
—————— i 
MTA O ey 
MTB 1 46 
MTC 2 45 
MTD 5 Wy 
MTE 4 43 
MTF 5 42 
MTH 6 Ta 
MTJ 7 4O 
MTK 8 39 


Table 51 (cont) 
I/O Assignment Table 


LOGICAL UNIT 


UNIT ean RRRMECH BIT 
MTL 38 
MTM 37 
MTN 36 
MTP 35 
MTR 34 
MTS 33 
MTT 32 
DRA 91. 
DRB 30 
DKA 29 
DKB 28 
LPA 27 
LPB 26 
CPA 25 
CRA 24 
CRB 23 
SPO 22 
PPA 21 
PRA 20 
PRB 19 
PPB 18 
DCA 17 
XXX (Used by 

ZIP) 
CDA 
CDB 
CDC 
CDD 
MTX 
CDE through CDZ, ex- 37 through 64 


cluding CDI and CDO, 
and CD2 through CD9. 


TINU is an array used by the 1/O routines and provides information 
about the I/O units. The entries in TINU are ordered according to 
logical unit number. Information about the unit with logical unit 


number, LUN, is in TINU [LUN]. All entries in TINU have the following 


format: 
HARDWARE 
UNIT MNEMONIC 
0 3 8 11 13 24 25 =~ 30 47 
Word Field Contents 
0 [0:3] Not used. 
[3:5] Unit number recognized by hardware. 
O [8:5] Not used. 
aes a7 | This field contains the logical unit 
number indicator, which has the following 
Characteristics. The expression 
(o&@TInu [LUN] . [5:11:7] /@1000000000000) 
will produce a result with all Zeros, ex- 
cept in the bit location corresponding to 
the RRR result bit location designated 
for the unit represented by TINU [LUN]. 
[18:12] Error count for unit while open. 
Unit [30:18] Three character abbreviation for the unit 
pene represented by TINU [ LUN]. For example, 
CRA. 


LABELTABLE, MULTITABLE, and RDCTABLE contain label information by 
logical unit number. 
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The LABELTABLE is the primary table in the group. The entry ofa 


unit into this table specifies one of the following: 
ae The unit is NOT READY. 


b. The unit is READY and contains a file that can be used 
for output (e685 a line printer file, or a magnetic 


tape file with a write-ring). 


ome The unit is READY and contains an input file not in-use 
(the LABELTABLE entry in this case would include the 


file identification of the input file), or 
d. The file is READY but in-use. 


The MULTITABLE contains the multiple file identification of the 
file, if any, on the unit represented by the table entry. The RDC 
Table contains the reel number, purge date, and cycle number of 

the file, if any, on the unit represented by the table entry. In- 
formation in the LABELTABLE, the MULTITABLE, and the RDCTABLE is 
obtained from the standard labels on the files, if the files are 

so labeled. Otherwise, the information can be supplied through the 
use of Label Equation Cards or operator messages. The STATUS Pro- 


cedure has the primary responsibility of maintaining these tables. 


LABELTABLE [I] contains the file identification for logical unit I. 
MULTITABLE [I] contains the corresponding multi-file identification. 
RDCTABLE [I] contains the corresponding reel number ([14:10]), cre- 
ation date ([24:17]), and cycle ([41:7]). If UNIT I is assigned 

to a program, RDCTABLE [TI], [8:6] contains a mix index. Special 
entries into the LABELTABLE include: 


Entry Contents 

@114 Unit not ready. 

~@14 Unit in use by system. 

@214 Unit is RW/L or saved. 

@314 Unit contains an unlabeled tape. 


+ Unit available. 


Entry Contents 


- Unit in use. 


O Scratch. 
For units O through 15: 


PRNTABLE [I] contains a 1 in [30:18] if the file is labeled, and, 
if assigned to a program, the address of the top 1/0 descriptor in 
[15:15]. -PRNTABLE [I] .. [21] ae 2 4 the wide has awrite ring. 
UNIT! s] contains the F field pointing to the first I/O in LIOQUE. 
TOQUELS] (waiting I/0 descriptors) contains the F field pointing 
to next I/O. If none, @77777 and C field points to UNIT[S]. 
TOQUEAVAIL points to the first open space in IOQUE; each then 
points to the next. 

FINALQUE| $ | (skeleton descriptors) contains the result expected. 
LOCATQUE|S] contains the location of the top T/O descriptor. 


DATA COMMUNICATION BUFFER 


PRIMARY DATACOM 
MEMORY STATUS DATA 


LINK WORD BUFFER 


NOTE 


With respect to File Link, [FF] 
link to next buffer, and [CF] 
address of top IOD. 


NON-DATA COMMUNICATION BUFFER 


SECONDARY FILE LINK 
MEMORY [FF | 


LINK [or] 


NOTE 


For input, READQ link; for output, ILL 
link. [FF | = points to previous entry. 
[cr | = points to next entry - the Data- 
com status word is the first word of 
the Data Buffer. 


FILE PARAMETER BLOCK (FPB) - ADDRESSED BY R+3. 


Each program has an FPB, which is created when a program is com- 
piled. It is later modified by the SELECTION Routine during the 
"fix-up" before a program is initiated. The FPB for a program has 


an entry for every file to be used by the program. 


When a file is declared in a program, that is, when the source 
program associates the file identifier with a file name and file 
handling techniques, the compiler assigns the file identifier a 
file number. This file number, rather than the file identifier, is 
then used in all references made to the corresponding file by the 
object program. For each file member, and in file number order, 
there is an entry in the program's FPB. Each entry in the FPB 
contains the file identifier, the multiple file identification, and 
the file identification for the particular number. The location 


and size of the FPB are placed in an entry of the program's zero 
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segment. When the SELECTION Procedure is performing "fix-up" op- 
erations, it uses this information to obtain the FPB. The FPB 


must be used at this time to process Label Equation Cards, if any. 


Label Equation Cards are special program parameter cards that can 
be used at run time to associate a file name with a file identi- 
fier used in the source language representation of a program. Each 
Label Equation Card contains the file identifier concerned and 

the equation information. The equation information includes the 
multiple file identification and the file identification to be 
associated with the file identifier. When SELECTION obtains a 
program's FPB, it also obtains all Label Equation Cards for the 
program, if any. Then the file identifiers in the FPB entries are 
compared with the file identifiers on Label Equation Cards. Ifa 
match is found, information in the FPB is replaced with the corres- 
ponding information from the Label Equation Card. It is in this 
way that file names associated with files represented by file 
identifiers can be decided at run time. After all Label Equation 
Cards for a program have been handled, SELECTION modifies the FPB 
again by removing the file identifier entries, which are no longer 
required. Then a descriptor containing the address of the compacted 
FPB is placed in a specified location in the object program's PRT. 
Using this description and a file number, the object program is 


able to make all necessary references to FPB entries. 


WORD 1 
MF ID 
O 6 A’? 
Word Field Contents 
O [0:6] Not used. 


Word Field Contents 


MF ITD [6:42] Seven characters multi-file identifica- 
tion. 
WORD 2 
FID 

O 6 47 
Word Field Contents 
O [0:6] Not used. 
FID [6:42] Seven character file identification. 
WORD 3 

REEL DATE 

O 18 i] 
Word Field Contents 
REEL [0:18] Reel number in three character alpha. 
DATE [18:30] Creation date in five characters. 
WORD 4 

_ jae | _ 
O 12 24 36 42 43 7 


Word Field Contents 


Cycle [0:12] Cycle number (two characters). 
Error [ 24:12] Total number of errors for this file. 
LU +1 [36:6] Logical unit number plus one. Zero 


indicates unit not assigned. 


Forms [42:1] 1 = types of forms messages. 
Type O = CP/CR. 
[43:5] 1 = LP only. 
2 = MT. 
3 = DG (designated). 
4 = LP/PBT. 
5 = specified unit (unlabeled). 
6 = PBT only. 
if eae = 
8 = PT unlabeled. 
9 = MT unlabeled. 
10 = disk. 
Ll = SPO. 
12 = disk serial. 
13 = disk update. 
14 = data communications. 
15 = PBD only. 
16 = PBT/PBD. 
17 = LP/PBD. 
18 = LP/PBT/PBD. 
19 = REMOTE 
WORD 5 
Word Field Contents 
File open [1:1] 1 = file is open. 
[2:46] I/O time on this unit. 


FILE INFORMATION BLOCK (FIB). 
At run time, there is one FIB generated for each file to be used by 


a program. An FIB is generated by an object program at each 
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program point corresponding toa file declaration in the source 
language representation of the program. Tnitially, the FIB con- 
tains only the information about file handling techniques provided 
in the source program. When a file is put to use, 1/o routines 

use a file's FIB to store information pertinent to the file such 

as block counts, record counts, etc. At the point when a file's 
FIB is created, a buffer descriptor area, containing an 1/o descrip- 


tor for each buffer area to be used for the file, is also created. 


Word Field Contents 
O Beginning file. 
1 Beginning reel. 
USE Routines (see note). 
2 Ending file. 
NOTE 
Field Contents 
[1:11] Starting index, BEFORE Routine. 
[12:12] Ending index, BEFORE Routine. 
[24:12 | Starting index, AFTER Routine. 
[36:12] Ending index, AFTER Routine. 
3 Ending reel. 
4 [1:1] 1 = USE Routines present. 
[2:1] 1 = labels omitted, 
[3:2] EOR rerun: OO = no, 
O1 = output tape, 
10 = scratch tape. 
[5:1] 1 = optional. 
[6:1] 1 = no I/O part. 
[7:1] 1 = sort file. 
[8:4] Internal type code. 
= CR 
L:-= LP 
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Word 
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= SPO 
= SPO 
= PBT 


Oo WON nN UU Fw Pd 
I 


Eo 
KH Oo 
Hou 
Qa 
Oo a 


12 = PBD 


(2759) 


[30:18] 


[1:1] 


[18:15] 


Contents 


= bits [13:11] are the file number. 
1 = bits [13:11] are the FPB index. 


See above. 
1 = release unit at CLOSE, 


Disposition of file. 
OO = rewind. 

Ol = no rewind. 

10 = RW/LK. 

11 = RW and release. 


Access mode. 
O = serial. 
1 = random. 


2 = update. 


Save factor. 


Used by File Security to indicate (in 
ALGOL and COBOL I/O ERROR Routines) that 
we do not have a parity, but an invalid 


user condition. 


Used by PRNPST/DISK to contain a count of 


the number of writes used. 


Word 


Le 


13 


Field 
[40:1] 
[41:1] 
[42:1] 
[43:1] 
[44:1 | 
[45:1] 
[46:2] 


[3315 | 


[15:10] 
[33:15 | 


Pavey 
[3:45] 


[1:9] 

[10:9] 
[19:1] 
[20:1 | 


[21:1] 


Contents 


1 = at end of file. 


CLOSED, unit retained. 


fat 
| 


L = CLOSED, unit released. 


1 = input. 


1 = reverse. 
Not used. 

O = unblocked. 
1 = TECH A. 

2 = TECH B. 

3 = TECH C. 


Block count. 
Record count. 


Relative PRT location of descriptor for 


hash totals. 


Number of rows. 
for disk files. 
Size of rows. 


Block already checked (COBOL). 


Rerun control (number of records). 
Rerun control counter. 

Number of records per block. 
Number of records in current block. 


Number of buffers requested. 


Number of buffers assigned. 


1 = bad key. 
1 = seek given. 
1 = read (first operation) for COBOL only. 


a= 15 


Word Field Contents 


[22:1] 1 = open. 
[23:1] 1 = write block back. 
[24:1] O = alpha (mode). 
[25:1] 1 = reverse (direction). 
[26:1] 1 = memory inhibit (for input). 
[27:1] 1 = input. 
[28:10] Current reel number. 
[38:1] 1 = forms. 
[39:5] External type code. 
[44s 3 | Not used. 
[4731] 1 = COBOL. 
14 Descriptor for disk file header in core. 


If file is open, 30 words. (See note. ) 


15 Error use input index. 


Error use input end index. 


[24:6 | Logical unit number. 
[30:10] Special select counter. 
[40:8 | Block count. 
16* Copy of current original 1/0 descriptor. 
17 Number of words left in the buffer. 
18 [3:15] Buffer size. 
[18:15 | TECH C buffer length. 
[33:15 | Maximum record length. 
19% Final T/o descriptor for program release 


(FINALQUE). 


* With flag bit off. 
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NOTE 
FIB[14] has a special use for printer backup 


files. 


[18:15] Pointer to current 18-word psuedo- 
buffer; i.e., area where next buffer load 


will go (count backwards). 


[33:15] Pointer to last available pseudo- 
buffer. 


When FIB[14].[FF] = FIB[14].[CF], then a 
PBIO must be done. 


FIB[ 5].[18:15] contains a count of the num- 

ber of writes (number of pseudo-buffers) used 
in this file. Used to put in I/O descriptor 
for use at print time to catch parities, dis- 


crepancies, etc. 


FILE TANK. 
ALGOL (Addressed by a descriptor located in the file's PRT cell.) 


Word Contents 

O Pointer to label (parity action label). nod used 
1 Pointer to label (EOF action label), } oy eee 
2 Pointer to FIB[O]. 

3 Poanves to read-in label if input. 


Pointer to build label if output. 
4 Pointer to top 1/0 qescuiter: 
5 Top I/O descriptor. 
6 


Remaining I/O descriptors. 
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COBOL 
Words 2 through N are located in the PRT for COBOL object programs. 


Words O and 1 are not present. 


LABEL EQUATION TABLE (USED BY SHEET [13]). 


Entries in the Label Equation Table are: 


Word Field Contents 
O Multi-file identification (seven 


characters). 


i File identification (seven characters). 
2 [ 0:18] Reel number (BCL three characters). 
[ 18:30] Creation date (BCL five characters). 
2) [0:12] Cycle (BCL two characters). 
[42:1] Forms message required bit. 
[43:5] File types: 
O = card punch or card reader. 
1 = line printer. 


a = labeled magnetic tape. 


3 = specific unit. 

4 = line printer or printer backup tape. 
5 = unlabeled specific unit. 

6 = printer backup tape. 

7 = paper tape. 

8 = unlabeled paper tape. 

9 = unlabeled magnetic tape. 

1O = random disk. 

li = SPO. 

12 = serial disk. 


13 = update disk. 
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Word Field 


4 [0:6 | 


[6342 | 
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12 
13 
14 


26 
27 
28 


29 


Contents 


14 = data communications. 
15 = printer backup disk. 


16 = printer backup tape or printer 


backup disk. 
17 = line printer or printer backup disk. 


18 = line printer, printer backup tape 


or printer backup disk. 
19 = remote. 


Number of characters in the internal file 


name. 


First seven characters of the internal 


file name. 


Remainder of the internal file name (as 


required). 


Equals ? if this is the last entry; other- 
wise, entries 14 through 25 are the same 


as above for the next file. 


Disk address of the next Label Equation 
entry. If there is no other entry, it 


equals O. 


SECTION 6 
MCP OPERATIONAL TABLES 


GENERAL. 

The MCP must have certain information about the object programs 

it is running and the equipment it is controlling. This information 
is stored in various tables and is updated during execution time. 
This section deals with the tables and procedures which sustain the 


operation of the MCP. 


PRT[ *,*]. 


The PRT is a two dimensional array. The rows of the PRT array are 
the PRT's of the object programs in the current mix. The rows of 
the PRT array are ordered according to the MIX indexes of the pro- 
grams in the mix. Access can be made to the PRT of a given program 
by accessing the PRT array with a row subscript equal to the pro- 
gram's MIX index; e.g., PRT [ MNDX, 7 | references the eighth word 

in the PRT of the program which has the MIX index MNDX. 


Word [I, *] of the PRT array is: 


ADDRESS OF 
FIRST WORD OF 
PRT FOR JOB 


WITH MIX 
INDEX 1 


O 1 2 8 18 33 i) 
Field — Contents 
[0:3] Identification. 
[3:5] 
[8:10] Size of PRT. 
[18:15] 
[33:15] Address of first word in PRT of 


object program (R+0). 


Format of Object Program's PRT: 


10 


11 


LZ 


13 


14 


Contents 


"EEEEEEEE" 


5 000....0 


F PB 


SD 


BC 


AIT 


MSCW 
INCW 


COM/PRL 


SIZEERROR/ 
OWN ARRAY 


TABLE 


ALGOLWRITE/ 
COBOLFCR 


Description 


Used by MCP to denote beginning of PRT. 


Used by ANALYSIS for branch to non- 


present label. 


"Memory" for normal state. 
y 


Descriptor pointing to FILE PARAMETER 
BLOCK. 


Descriptor pointing to SEGMENT 
DICTIONARY. 


Descriptor pointing to BLOCK CONTROL 


intrinsics. 


Descriptor pointing to ARRAY INFOR- 
MATION TABLE. 


Mark Stack Control Word. 
Initiate Control Word. 


Location to store constants for the 


Communicate and Program Release 


operators. 


Data descriptor pointing to R+0. F 
field points to location of stack 


bottom. 


Descriptor pointing to OAT in ALGOL. 


COBOL [FF] points to the PRT cell re- 
served for SIZE ERROR indicator. 


Program descriptor pointing to write 
intrinsics for ALGOL, and to FCR for 
COBOL. 


16 


17 


20 


21 


ead 


23 


24 


25 


26 


Contents 


ALGOLREAD 


ALGOLSELECT/ 


COBOLREAD 


O 


BLOCKCTR 


JUNK 


EXITR 


LISTRTN 


ERROR 
COUNT 


SAVE TIME 


Description 


Program descriptor pointing to read 


intrinsics for ALGOL. 


READ/WRITE descriptor pointing to 
select descriptor for ALGOL. 


ZERO. 


Block level counter (starts at 1 with 


outer-most block of symbolic programs). 


Temporary storage location for use by 


software. 


Character mode descriptor which refer- 
ences the first syllable of the program; 
i.e., the outermost block which is gen- 


erated by the compiler. 
Used to obtain next element of a list. 


Program descriptor of block number 2; 
i.e., the block which corresponds to 
the outermost block of the symbolic 


program. 


Storage location used by compiler to 
store the error count. First PRT 


location assigned by compiler. 


Length of time to save object code. 


Cells 22 through 25 are used in this context by ALGOL. 


The PRT contents of a FORTRAN object program ares: 


Cell Contents 
R +0 EEEEEEEE 
1 Used by .LABEL. 
2 500000000...0 
3 FPB 
4 SD 
5 BC 
6 AIT 
7 MSCW 
10 INCW 
11 COM/PRL 
12 R + 0, stack 
13 OWNARRAY description 
14 ALGOL WRITE 
15 ALGOL READ 
16 ALGOL FILE CONTROL 
17 O 
20 BLOCKCTR 
21 JUNK 
Ae BASENSIZE 
23 LISTRTN 
24 CLASN 
25 HOLTOG 
26 Powers of ten 
27 21 word ARRAY for any formatted output and for use by ZIP. 
30 ERR 
ep? SQRT 
32 ARSIN 
33 EXP 
34 SIN 
35 ALOG 
36 TAN 
37 ATAN 
4O GAMMA 
Al. DATAN 
42 DCOS 
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Cell Contents 


R + 43 DSIN 
AY ATAN2 
AS CABS 
46 DMOD 
17 DEXP 
50 DSQRT 
BED [ *]. 


The BED array, the SLEEP, and COMPLEXSLEEP procedures are used to 
suspend the processing of an object program until a certain condi- 
tion exists. Two word entries into the BED are made through use 

of the SLEEP Routine. The last entry in the BED is pointed to by 
JOBNUM. The BED is also used by the NOTHINGTODO Routine to restart 
jobs which have been temporarily suspended. Entries made by the 
SLEEP Routine are: 


WORD 1 


ADDRESS 
OF WORD 


TO BE 
TESTED 


Contents Field Description 

5 [0:3] Descriptor identification bits. 

MIX [3:5] MIX INDEX of suspended program. 

O [8:10] Size field. 

rk [18:15] F Register setting for suspended program. 
Address [33:15] Address of word to be tested to determine 


if the necessary condition is satisfied. 
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WORD 2 


MASK WORD 


O 7 
Word Field Contents 
O [O:1] Flag bit (cannot be used for mask bit). 
MASK [1:47 | Contains ones in bit positions which 


indicate when the needed condition is 
present. All other bits are set to 


Zero. 


Entries made via the COMPLEXSLEEP Routine are: 


WORD 1 


ADDRESS OF 
WORD TO BE 


TESTED 


Word Field Contents 

0 [0:3] Operand identification bits. 

MIX [3:5] MIX INDEX of suspended program. 

O [8:10] Size field. 

rk [18:15] F Register setting for suspended program. 


Word Field Contents 


Address [39215] Value to be tested against the result 
from the procedure called by accessing 


word 2. 


WORD 2 


ACCIDENTAL ENTRY PROGRAM DESCRIPTOR 


Word Field Contents 
Program [0:48] Program descriptor which, when accessed, 
Descriptor 


will return a value of 1 if the suspended 
program can be reactivated. It returns 
a value of O (zero) if it cannot be re- 


activated. 


As conditions dictate, NOTHINGTODO searches the BED to determine if 
a program can be reactivated. Essentially, the following statements 


indicate how the test is made. 


NTL := Index of entry to be tested; 

NT2 := BED [NT1] ; 

NT3 := BED [NT1 + 1] ;3 

IF NOT (NT2 AND NT3) # NOT O THEN START JOB; 


BED is ordered by priority. 


JOBS ACTUALLY RUNNING: (sAR) eyes 
The SELECTION routine will fill the JAR from the SHEET when enough 


space is available to run a job. Entries in the JAR are ordered by 


mix index and are: 
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Word 


Field 


[1:1] 


[1:2] 


[ 8:10] 


[18:15 | 


[33:15] 
[8:10 | 


[33:15] 


[1:23] 
[24:24 | 


[18:15] 


Contents 


Object program's first name (seven char- 
acters). If this is a compiler, this 


entry is < O. 


Object program's second name (seven char- 
acters). If this job is in the process 


of being DS-ed, this entry is < O. 


After SELECTION, if this program was 
compiled using COBOL = l. 


During SELECTION, as follows: 


O = normal. 

2 = job has been XS-ed. 

3 = job has been ES-ed. 

O = go job (from Compile-and-Go). 
1 = compiler (Compile-and-Go). 

2 = execute job. 

3 = compiler (syntax check - set to 2 

later). 
4 = compiler (Compile-to-Library). 
= run job. 

99 = aborted job (from Initialize). 


1023 = syntax errors. 


Skeleton disk address (if JAR [2] . [8:10] 
= 1, 2, or 4) for the skeleton SHEET for 
GO part. 


Priority. 
Scheduled identification for this job. 


Estimated processor time. 


Estimated I/O time. 
Starting date for the log (binary), 


Starting time for the log. 


Size of log information in ESPDISK. 


Word Field Contents 


6 [33:15] Location of the first record of the log 
information in ESPDISK. If [2] . [8:40] 


= 0, then this is the compile log infor- 


mation. 
Pi Idle time. 
8 Length of each row of the code file. 
9 Number of rows. 
10-29 Disk address for each row of the code 


file. 


The code for a given program may be located by using the JAR entries 
beginning at JAR [10]. The Segment Dictionary for any given normal 
state program contains a disk address in the (33225) field which 

is the address of that segment, relative (by disk segment ) to the 

JAR [10] entry. If any given relative address exceeds the JAR [8] 
length, then the next row (JAR [11], JAR [12], etc.) is automatically 
chosen for the location of the code on the disk. The following for- 
mula may be used to locate a given segment of code on the disk for 


a given program: 


Assume RD = the relative disk address from Segment Dictionary 
entry [33:15] field. 
DISK SEGMENT ADDRESS = (JAR [PIMIX, (RD DIV JAR [PiMIxX, 8]) 
+ 10]) + (RD MOD JAR [P1MIx, 8]) 


Mix indexes which are inactive are indicated by a zero entry in 
JAR [MIX]. If a breakout has been done, JAR [10] = 0, and the Seg- 


ment Dictionary addresses point to the copied code file in backup 


storage. 


SLATE ae 


The SLATE is a queue of requests to run independent MCP routines 
whose functions are not directly related to object programs; e.g., 


STATUS, CONTROLCARD, SELECTION, and RUN. 
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MCP routines which desire to run independent routines cause entries 
to be made in the SLATE by calling the INDEPENDENTRUNNER Routine and 
passing the address of the program descriptor for that routine and 

a parameter for the routine. INDEPENDENTRUNNER then makes the two 
necessary entries into the SLATE. The first word of an entry is a 
parameter to the routine. The second word of an entry is the PRT 
address of the routine. NSLATE and LSLATE are pointers into the 
SLATE. NSLATE points at the last entry which was started, and 
LSLATE points at the last entry placed in the SLATE. 


Routines noted in the SLATE are called out by the NOTHINGTODO Routine 
on a first-in, first-run basis. All entries in the SLATE have the 


format: 


WORD 1 


PARAMETER 


O Wey 


[0:48] varies according to routine. The parameter is for the 
Independent Routine. 


WORD 2 


ADDRESS 
O 


33 47 


If word 2 is negative ([1:1] = 1), this program was compiled by 
COBOL. 
6-10 


Word Field Contents 


0 lors 

Address [33:15] Address points to the program descriptor of 
the Independent Routine. 

SHEET [*]. 


The SHEET provides information to the SELECTION Routine to introduce 
jobs into the mix. Entries in this table are made by the CONTROL- 
CARD Routine. Entries in the SHEET are: 


Word Field Contents 
O Object program's first name (seven charac- 


ters). If this is a compiler, this word is 


=O 


1 Object program's second name (seven char- 


acters). 


2 [1:2] O = normal, waiting. 
2 = job has been XS-ed. 
3 = job has been ES-ed. 
[8:10 | 0 = go job (from Compile-and-Go). 
1 = compiler (for Compile-and-Go - set to 
2 later). 
2 = execute job. 
3 = compiler (for syntax check). 
4 = compiler (for Compile-to-Library). 
5 = run job. 
[18:15] Skeleton disk address (if SHEET [2] . 
[8:10] = 1, 2, or 4). 
[33:15 | Priority (same as SHEET [18]). 
3 [8:10 | Schedule identification for this job. 
[33:15 | Estimated processor time. 
y Estimated I/O time. 
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Word Field Contents 


[1:23] Starting date for the log (binary). 
5 [24:24] Starting time for the log. 
6 [1:1] 1 = new format for Label Equation Cards. 
[18:15 | FPB Information. 
[33:15] Location of the first part of the log. 
7 
8 
10 
11 
12 Stack size. 
13 Disk address of Label Equation entries 
applicable to this entry only. 
14 
15 Disk address of Label Equation entries 
presented when program was compiled, and 
applicable to all executions of this job. 
16 Estimated processor time. 
17 Estimated I/O time. 
18 Priority, 
19 Common value. 
20 Estimated core requirement. 
21 Stack size 
22 Time to save program (on Compile-to- 
Library). 
23 [9:9] Remote station address, if any, other- 


wise, O. 
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Word Field 


[31:17] 


24 
25 
26 
27 
28 
29 


Contents 


Time this job was entered in the SHEET 
(for TS message). 


User code. 


Disk address for next SHEET entry (= 0, 
if this is the last entry). 


The word, field, and contents for the format of segment zero for the 


programs is: 


Word Field 


O 


7 [18:15] 
[33:15] 


11 
12 


Contents 


Relative location of the Segment Dic- 


tionary. 


Size of the Segment Dictionary. 


Relative location of the PRT. If < O 
then job compiled by COBOL. 


Size of the PRT. 


Relative location of the File Parameter 


Block. 
Size of the File Parameter Block. 


Starting segment number. [1:1] mee Cae ee 


new format, else O. 


Core requirement/64. 


Number of files. 


Word Field Contents 


13 

14 

15 Disk address of Label Equation entries 
presented when program was compiled and 
applicable to all executions. 

16 Estimated processor time (from 
compilation). 

Ly Estimated I/O time (from compilation). 

18 Priority (from compilation). 

19 Common value (from compilation). 

20 Estimated core requirements (from 
compilation). 

21 Stack size (from compilation). 

ne 

23 

24 

25 

26 

a7 

28 

29 


SEGMENT DICTIONARY AND RELATED PRT CELLS AS CREATED BY A COMPILER. 
Each program has a Segment Dictionary containing one entry for every 
program segment in the program, and one word for every intrinsic 
used. The first word in the Segment Dictionary is referenced as 


word zero. The entry for any particular segment is located in the 


Segment Dictionary word that corresponds to that segment's number; 


e.g., the entry for segment 3 would be in the fourth word of the 


Segment Dictionary. 


A Segment Dictionary entry as created by a compiler contains the 


following information, except for entries for intrinsics. 


a. The relative address of the segment within the program 
file on disk. Relative address zero is reserved fora 
special segment which contains such information as a 
pointer to the PRT, a pointer to the Segment Dictionary, 


a pointer to the program parameter block, etc. 
b. The size of the segment. 


c. An index into the PRT of the first program descriptor 


that references the segment. 


d. A flag specifying whether or not the segment is a type 
2 segment. 


Entries for intrinsics provide no segment size and have the intrin- 
sics number in lieu of the relative disk address. Otherwise, they 


are the same. 


Although each Segment Dictionary entry may have one or more program 
descriptors in the PRT, some have none; e-&.-, fill segments. The 
program descriptor entries in the PRT, as created by a compiler, 


contain the following: 


a. The relative address within the segment pertinent to 


the program descriptor. 


b. The index into the Segment Dictionary of the entry ior 
the segment to which the program descriptor pertains. 


This index is equal to the number of the segment. 


c. A link (index) to the next program descriptor which 


addresses the same segment. 
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d. A stop bit if the program descriptor entry is the last 


one pertaining to the segment. 


FIELDS AND THEIR VALUES FOR THE SEGMENT DICTIONARY AND THE RELATED 
PRT CELLS. 


This topic is dealt with by focusing on the fields and the values 
of, first, the Segment Dictionary, and, second, the PRT. The 


fields and their values for the Segment Dictionary are: 


Field Field Value 

[0:1] 

[1:1] 1 for type 2 segments (DATA), otherwise, 0. 

[2:1] 1 for intrinsics, otherwise, 0. 

[3:1] Reentrant bit. 

[424] 

[ 8:10] Link to program descriptor in PRT (links to first 


entry in link-list). 


[18:15] If program segment, size of segment; if present, its 
location in core. For intrinsics, it is mean- 


ingless. 


[33:15] Disk address of segment or intrinsic number 
(relative). 


The fields and their values for the related PRT Cells are: 


Field Field Value 

[o:4] Non-present program descriptor bits. 

[4:2] Mode and argument bits. 

[6:1] Stop bit showing end of link list. 

ree a If stop bit is on to indicate that it is the last 


entry, this field contains the index into the 
Segment Dictionary. Otherwise, it is a link (in- 
dex) to the next program descriptor that references 


the segment. 


Field Field Value 


[18:15] Index into Segment Dictionary of the entry per- 
taining to the segment. 


[33:15] Relative address within the program segment per- 
tinent to the program descriptor. 


FORMAT OF FIRST 30 WORDS (1 DISK SEGMENT) OF ALL PROGRAM FILES. 
The first 30 words, starting at relative address 0 (zero), of all. 


program files must have the following format: 


Word Field Contents 

O Location of Segment Dictionary. 
1 Size of Segment Dictionary. 

a Location of PRT (0 if compiled 


using COBOL). 

Size of PRT. 

Location of File Parameter Block. 
Size of File Parameter Block. 


Starting segment number. 


NII BW LU | W 


[33:15] Number of files. 
[18:15] Core requirement/64.— 


8-29 Not used. 


NOTE 
The locations noted above are specified accord- 


ing to their relative address within the 
program file. Sizes are expressed in terms 


of number of words. 


METHOD FOR DECLARING ARRAY SPACE. 
The call on the DF MCP to declare array space is nearly identical 
to the call made when using the MD MCP. With the exception that 


a different literal value is used to specify the type of storage, 


the same parameters are required in the stack. However, when the 
DF MCP is called, an operand call on a block control intrinsic pro- 


gram descriptor is used rather than a communicate operator. 


The following parameters are required in the stack: 


a. Mark Stack Control Word. 


b. Descriptors pointing to the array descriptors for 


each array being declared. 


ome Sizes of the array dimensions. 
d. Number of dimensions. 
e. Number of arrays being declared. 


ff. TYPE of storage. 


With these parameters in the stack, an operand call on the block 
intrinsic program descriptor will cause the array space setup. The 


values for TYPE are defined as follows: 


= Regular array space (overlayable). 
= SAVE array space (non-overlayable). 


OWN array space. 


Wo ND F OO 
NW 


= SAVE and OWN array space. 


NFO. 
NFO contains the following for each active mix index and is used 
for reconstructing the PRT for stack overflow conditions. NDX 


represents the number of entries per job in the NFO Table. 


NFO [ (MIX-1) times NDX] = File Parameter Block data 


descriptor. 


NFO [(MIX-1) times NDX+1] = Segment Dictionary name 


descriptor. 
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NFO [ (MIX-1) times NDX+2] = Location of bottom of stack 
(word containing all B's). 

NFO [(MIX-1) times NDX] . [1:17] = Clock time at BOJ. 

NFO [(MIX-1) times NDX] . [18:15] = Core estimate DIV 64. 

NFO [ (MIX-1) times NDX] . [33:15] = Location of stackbottom. 
LOOKQ. 
LOOKQ is a variable in the MCP's PRT which will point at the first 
entry for a logged-in user of a remote device. Each entry is ten 
words long, including the memory link. Each entry links to the 


next and will eventually point back to LOOKQ. The format of the 


LOOKQ word is: 


Field Contents 

[0:9] O 

[9:9] @777 

[18:15] Address of secondary link word for last entry. 
[33:15] Address of secondary link word for first entry. 


LOOKQ entry: 


Word Field 
O 
i. 
[0:9] 
[9:9] 
[28254 
[33215] 
2 
3 


Contents 


Memory link word for save memory 


type. 

Secondary link word. 

O 

Terminal and buffer number. 
Address of next entry. 
Address of previous entry. 


User code. 


CCMASK1 


Word Field Contents 


CCMASK2 
5 INFOMASK1 
6 INFOMASK2 
4 MIXMASK 


Time when user logged in (sec/60). 


Not used. 


MESSAGEHOLDER. 
The MESSAGEHOLDER is dealt with as follows: 


Field Contents 
[18:15] Points at the last buffer added to the SPO queue. 


The first word of each message starting at MESSAGE- 
HOLDER [33:15] is a memory link address of the next 
message in the SPO queue that is to be printed. The 
last message in the SPO queue will contain zeroes 


in the first word. 


[33:15] Points at the SPO message that is currently being 
printed or the next SPO message to be printed. 


A maximum of 100 messages of varied length (length depends on the 
routine that calls SPOUT) may be placed in the SPO queue. NUMESS + 
100 equals the number of messages left in the SPO queue. If NUMESS 
equals -100, then the SPO queue is empty. The messages must contain 
a group mark (-). If not, when SPOUT is called, the memory follow- 


ing the message will be printed and destroyed. 


INQUIRY: ARRAY DCB [16 | AND THE ORR WORD. 


DCB is a table used by the data communications'! handling procedures. 
Initially, all words in DCB = 0. There are two pointer words used 
in conjunction with DCB. These pointer words are NEXTINQ and 
CURRINQ. NEXTINQ points at the word in DCB that will be used when 
handling the next Inquiry Request Interrupt. CURRINQ points at the 


6-20 


word in DCB that will be used when handling the next COM9; i.e., 
the next FILL (array row) WITH INQUIRY statement. 


HANDLING AN INQUIRY REQUEST INTERRUPT. 
When an Inquiry Request interrupt occurs, DCB [NEXTINQ] is tested 


to see if it equals zero. If it is zero, a buffer area is obtained 
and its address is placed in DCB [NEXTINQ] . [33:15]. Then a read 
is performed to handle the interrupt, and the number of words in 
the message is placed in DCB [NEXTINQ] . [18:15]. If DCB [NEXTINQ|] 
were not zero, it would already be set-up with the address and 


size of an available buffer area. 


If after the read is performed, the result descriptor shows that 
input was received, DCB [NEXTINQ] . [1:1] is set to 1, DCB [NEXTINQ] 
. [14:4] is set to the terminal unit number of the unit that pro- 
vided the message, and the ORR word (see below) is set to note that 
the TU is “output ready" or “output possible." 


If the result descriptor shows an "output ready" condition (tieSs5 
ready for another line of a message), DCB and NEXTINQ are left as 
is, and the ORR word is set to indicate the "output ready" condi- 


tion. 


HANDLING A FILL WITH INQUIRY. 


When a communicate indicates that an inquiry message is requested, 
DCB [ CURRINQ | is tested for a value less than zero; i.e., tested 

to see if DCB [CURRINQ] . [1:1] = 1. If DCB [CURRINQ] is less 

than zero, the message from the buffer area addressed by DCB 

[ CURRINQ] . [33:15] is supplied to the requestor, together with 

the TU number in DCB [CURRINQ] . [14:4]. CURRINQ is then incremen- 
ted to the next location. The space for buffer area addressed by 
the previous CURRINQ word is returned. If DCB [CURRINQ] is not 
less than zero, the requestor is put to COMPLEXSLEEP waiting on 
DCB [CURRINQ] < 0. | 


THE ORR WORD. | 
The ORR word indicates the “output ready" status and "output possi- 


ble" status of all TU's. A unit is "output ready" and "output 
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possible" if the TU is waiting for a message. If it is handling 


one line of output and will be coming back for another, 


it is "out- 
put possible," but not 


"output ready." 


The following tests provide 
"output ready" and "output possible" 


information. 


IF (TWO (TU) AND ORR) # O THEN OUTPUT READY 


IF (TwO (TU + 15) AND ORR) #4 THEN OUTPUT POSSIBLE 


NOTE 
TWO is a function such that TWO (X) = 2 * X. 
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SECTION 7 
BINARY CARDS 


GENERAL. . 

Once after every Halt/Load (H/L) operation, the initial operations 
call the INITIALIZE Routine into action. The Routine reads from 
disk into core the information which was entered into the system 
through the MCP load deck and stored on disk by the Cold Start 
Routine. This information is niece in certain MCP PRT variables. 
The Routine initializes and updates the tables used by MCP (PRT, 
SHEET, etc.),; and performs the first organization and classification 


of core storage. It also creates the Available-Disk Table. 


After these operations, the MCP prints the H/L messages on the SPO. 
During initialization, the field used to maintain the ready or not 
ready status of the peripheral units is set to indicate that all 
units are in not ready status. The first execution of the N-Second 


Routine sets the indicators properly. 


This section on Binary Cards presents the H/L Button Card, the 
ESPOL Transfer and Load Cards, and the Initialization Code brought 
in by the H/L Card. 


H/L CARD. 

Information in the log is not lost due to H/L operations. When the 
log becomes half full, a message is typed to notify the operator. 
When the log is almost full, an MCP routine is fired up which 
changes the name of the SYSTEM/LOG and which initializes a new 
SYSTEM/LOG. The new name that is given to SYSTEM/LOG is (M) (D) 
(c) /SYSLOG where <M) = a two digit number representing the month of 
the year, {D) = a two digit number representing the day of the 
month, and {C) = a three digit number that is incremented each time 
the name changing routine is invoked. A keyboard message which 
gives the new name is written after the name has been changed. For 


example, 


*%*** NEW LOG FILE IS 1230007/SYSLOG 


Table 7-1 presents the H/L Button Card, and figure 7-1 presents a 
flow chart of the H/L Card. 
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Table 7-1 


H/L Button Card 


Mark Stack 
Literal 702 
Literal 74 


Branch Forward Unconditional (40-0) 


Word Mode 
Program 


Descriptor 


O441 
3410 
0360 
4231 
7500 
0000 
0000 
0023 
0211 
0014 
4131 
0435 
7012 
7007 
O421 
0014 
WMTL 
0054 
4131 
4155 


Interrogate Interrupt 
Literal 3 
Branch Backward Unconditional (22-0) 


Exit 


Operand Call F-2 
Descriptor Call F-1 
B Store Destructive 


Literal 3 


Initiate I/O 
Literal 13 
Branch Backward Unconditional (22-0) 
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Table 7-1 (cont) 


H/L Button Card 


Dial B 64 
Transfer Bits 10 
Literal O 


B Not Equal to A 


Literal 17 
Branch Backward Conditional (22-3) 
Literal 15 


Branch Backward Unconditional (23-3) 


Literal O 
Operand Call 14 
Literal 15 


Branch Backward Unconditional (24-3) 


Literal O 
Operand Call 15 
Literal 21 


Branch Backward Unconditional (24-3) 


Literal O 
Operand Call 16 
Literal 25 


Branch Backward Unconditional (24-3) 


Table 7-1 (cont) 


H/L Button Card 


0000 
0076 
0144 
4131 
5140 
0000 
4070 
0137 
5140 
0000 
4770 
O461 
5140 
0000 
4770 
4223 
7700 
0000 
0000 
0037 


Literal O 
Operand Call 17 


Literal 31 


Branch Backward Unconditional (24-3) 


Disk File Read Descriptor 
7 Segments 
from address specified 


in 0137 


Disk File Read Descriptor 
77(8) Segments 
from address specified 


in O461 


Disk File Read Descriptor 
77 (8) Segments 
from address specified 


in 4223 


Character Mode 
Program 


Descriptor 


Table 7-1 (cont) 


H/L Button Card 


Recall Source Address F-l 
Recall Destination Address F-2 


Transfer Words O4 


Exit Character Mode 


Descriptor Call 35 
Operand Call 21 
Mark Stack 


Literal 9 


Descriptor Call 34 
Operand Call 21 
Mark Stack 


Literal 2 


Descriptor Call 33 
Operand Call 21 
Mark Stack 


Literal 14 


Literal 140 
Operand Call 36 
Literal 124 


Branch Backward Unconditional (17-0) 
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ESPOL TRANSFER CARD. 
This is an alphanumeric card, which is the final card in the MCP 


Load Deck and the COLD START Deck. Table 7-2 presents this card. 


Table 7-2 


ESPOL Transfer Card 


Li 7500 
0000 


0000 


5355 
3061 


7006 
0004 


O421 


0000 


0000 


0012 


1765 


0435 


0015 


Word Mode 
Program 


Descriptor 


Literal 1 
Dial A 53 (C Field) 
Dial B 30 (F Field) 


Transfer Bits 1510 


Operand Call F-1 
Literal 1 
B Store Destructive 


Exit 


Character Mode 
Program 


Descriptor 


Table 7-2 (cont) 


ESPOL Transfer Card 


Recall Source Address F-2 

Recall Destination 

Address F-1 

Begin Loop 63 The 3969 

10 

words 

Transfer Words 6340 starting 
at 00160 
are re- 
located. 

End Loop 

Exit Character Mode 

Mark Stack 


Operand Call 11 


Mark Stack 
Literal 160 
Literal 20 


Operand Call 14 


Literal 10 


Branch Backward Unconditional (16-2) 


NOTE 


20 is overlaid by character 


mode transfer in 15-3. 


ESPOL LOAD CARD. 

This card is a binary card, which is the first card of the MCP Load 

Deck or the COLD START Deck. The card is presented in table 7-3. 
Table 7-3 


ESPOL Load Card 


——— 
20 0104 Literal 21 
AWII INITIATE 1/0 
0020 Literal 4 


4231 Branch Forward Unconditional (22-0) 


21 5240 Card Read Descriptor 
1200 Alpha 12. Words 
4000 CRA 
OO4k 


22 AWS S Dial A 44 (Bit 20) 
O211 Interrogate Interrupt 
0020 Literal 4 
4131 Branch Backward Unconditional (22-0) 
! 


3 7790 Character Mode 
0000 Program Descriptor 


0000 


0024 


Table 7-3 (cont) 


ESPOL Load Card 


Recall Source Address F-4 


Recall Destination Address F-3. 


Call Repeat Field F-2 


Transfer Words 


Exit Character Mode 
Transfer bits OO 
Literal 20 


Branch Backward Unconditional (22-0) 


Literal 22 
Branch Backward Unconditional (22-0) 
Dial A OO 


Dial A OO 


Literal O 
Operand Call 14 
Literal 12 


Branch Forward Unconditional (32-2) 


Literal O 
Operand Call 15 
Literal 6 


Branch Forward Unconditional (32-2) 


Table 7-3 (cont) 


ESPOL Load Card 


31 0000 
0072 
0010 
4231 
32 0000 
0076 
7561 
0165 
33 0010 
0231 
0010 
4131 
34 OoO04 
0107 
. 2025 
Ooo44 
135 0106 
2025 
3355 
4O61 
7-12 


Literal O 
Operand Call 16 


Literal 2 


Branch Forward Unconditional (32-2) 


Literal O 
Operand Call 17 
Dial B 75 


Transfer Bits O1 


Literal 2 


Branch Forward Conditional (34-0) 


Literal 2 


Branch Backward Unconditional (33-2) 


Literal 1 
Descriptor Call 21 


Duplicate 


Literal 11 


Operand Call 21 
Duplicate 
Dial A 33 


Dial B 40 


SE TL NT AS eT aE i PC SSNS 13 SA I SE ES 


Table 7-3 (cont) 


ESPOL Load Card 


Transfer Bits 


Duplicate 
Transfer Bits 


Duplicate 


Transfer Bits 
Duplicate 
Transfer Bits 


Dial A 53 


Dial B 53 
Transfer Bits 
Literal O 


Literal 11 


Operand Call 21 
Duplicate 
Dial A 15 


Dial B 22 


Transfer Bits OL 


Dial A 22 
Dial B 72 


Transfer Bits O4 


Table 7-3 (cont) 


ESPOL Load Card 


Mark Stack 
Operand Call 23 
Literal 120 


4131 Branch Backward Unconditional (20-0) 


INITIALIZATION. 
The B 5500 System is initiated when the machine operation performs 


an H/L operation by pressing the HALT switch, then the LOAD switch. 


The operation automatically caused Processor one to go into control 


state and a portion of code to be read into the first locations of 
core memory in module zero. Control is then automatically trans- 
ferred to core address 16 and the system is in operation. Initial 
operations cause the INITIALIZE Procedure and permanent segments 

of the DC MCP to be read from disk into core. The DC MCP then per- 
forms various initialization functions, including performing the 
first organization and classification of core storage, and creating 
the Available-Disk Table. Table 7-4 presents the format for the 
Initialization Code brought in by the H/L Card. 


Table 7-4 


Initialization Code Brought in by H/L Card 


Character Mode 
Program 
Descriptor 


0015 


Table 7-4 (cont) 


Initialization Code Brought in by H/L Card 


Recall Source Address F-2 


Recall Destination 
address F-l1 


Begin Loop 6356 Starting 
at 00160, 

Transfer Words 63 0 the 3969 
t words are 
relocated 
beginning 

End Loop at 00020. 


Exit Character Mode 


Mark Stack 


Literal 160, 


Literal 20. 


Operand Call 14. 


NOTE 
Enter at 17-O from branch command 


43-3 of the H/L Card. 


Operating Conditions: 


a. Timer can be on. 
Da Printer Finished or Keyboard Request will stop the program. 
ec. Will work on any I/O Channel. 


SECTION 8 
LIBRARY MAINTENANCE 


GENERAL. 


Procedures are available to maintain the user program library, con- 
struct requested library entries, and to update the associated 
tables. Section 8 deals with library maintenance action by pro- 
viding a detailed depiction of the format for a library tape and 
the format of a library maintenance segment used for load informa- 


tion. 


FORMAT OF A LIBRARY TAPE. 

The contents for each physical record determines the format of a 
library tape. Figure 8-1 presents this information in a sequential 
manner, providing a place for everything from tape label to tape 


mark. 


PHYSICAL 


RECORD 


10 


1l 


NO. 


CONTENTS 


TAPE LABEL 
TAPE MARK 


LAST ENTRY DENOTED BY AN 


@14 1023 WORDS MAX SIZE TWO WORDS 
PER ENTRY 


TAPE MARK 


COPY OF RECORD 
NO. 1 LABEL 


LABEL FOR FILE NO. 1 
TAPE MARK 


FILE HEADER FROM DIRECTORY 
30 WDS 


CONTENTS OF FILE (ROW BY ROW) 
IF ROW > 900 WDS THEN 900 WD 
BLKS ELSE ROW SIZE BLOCKS 


TAPE MARK 


LABEL (COPY OF 
RECORD NO. 6) 


LABEL FILE NO. 2 


REPEATED FOR 


TAPE MARK EACH FILE 


ETC. 


TAPE MARK, LAST 
RECORD ON TAPE 


Figure 8-1. Format of a Library Tape 


FORMAT OF LIBRARY MAINTENANCE SEGMENT FOR LOAD INFORMATION (SHEET 
ENTRY). 


The SHEET entry for load information requires a specific format for 
each library maintenance segment. Figure 8-2 provides the format 


for a segment to illustrate the arrangement of words and programs. 


[o].[2:6] 


.[ 831] 


UNITNO = 23, 24 or > 32. 


1, DUMP EXPIRED FILES. 


[FF] = T, no, indicating LOAD, DUMP, etc. (see MCP 
procedure RESWDS). 


[1] TAPE LABEL 

[2] MULTI-FILE ID 

[3] FILE ID 

eve MULTI-FILE ID 

[28 | FILE ID 

[ 29 | ESPDISK ADDRESS LINK 

Figure 8-2. Format of the Library Maintenance 


Segment for Load Information 


SECTION 9 
INTERRUPT HANDLING 


GENERAL. 

Interrupts are initiated by the hardware itself when the computer 

is operating in normal state and certain conditions are encountered. 
The MCP also provides facilities that allow programs to have rerun 
points. If a program requests a breakout, all processing of object 
programs is halted. Subsequently, all of memory and overlay storage 
is written on magnetic tape; then, in the case of a breakout, object 


programs are re-initiated and continue processing. 


When a program is to be restarted at a rerun point, no programs may 
be on the system. Also, all files related to the program(s) to be 


restarted must be in place on the units where they were at breakout 
time. At such a time, a restart request will be handled by reading 


the restart information and restoring core to the condition that 


existed when the breakout occurred. Then, overlay storage is re- 
stored. 
Finally, only that program is restarted. Other programs, which may 


have been in process when the breakout occurred and which are re- 
flected in the restored memory and overlay storage, are terminated. 
The BREAKSTART Procedure is the primary procedure used to perform 
breakouts and restarts. Section 9 focuses on the handling of a 


Presence Bit Interrupt in the operation of B 5500 Hardware and 


Software. 


PRESENCE BIT INTERRUPT ACTION. 

When a Presence Bit Interrupt is detected, control is transferred 

to the Presence Bit Routine. The fact that a Presence Bit Interrupt 
occurred means that a program has executed a syllable that caused 


an attempt to access information described by a descriptor with a 


zero presence bit. The following action takes place: 


a. Presence Bit Interrupt is set in Central Control by the 


attempt of a normal state program to access a non-present 


data descriptor. This is a descriptor with bit [2:1] = 


9-1 


This being a syllable-dependent interrupt, it is sensed 
at SECL (Syllable Execution Complete Level) time. This 
causes an SFIL (Store for Interrupt Level) operator to be 


placed into the T Register. 


The B Register is pushed down. 
The A Register is pushed down. 


If you are in character mode, build and push down an 
ILCW (Interrupt Loop Control Word). 


Build and push down an ICW (Interrupt Control Word). 
Build and push down an IRCW (Interrupt Return Control Word). 


Build an INCW (Initiate Control Word) and place it in the 
object (normal state) program's PRT at R + 10 (octal). 


Force an INI (Interrogate Interrupt ) operator into the 
T Register. 


Transfer to either Cell 55 (octal) or Cell 67 (octal), 
depending on whether this was a Presence Bit on Pl or 
P2. Set the R Register to zero. Set the S Register to 
100 (octal). 


Place an 18 (decimal) in the TOS (Top of Stack) at 
Cell 101 (octal). 


Transfer to the MCP Outer Block Label P1PROCESS. 


set the S Register to point at the IRCW stored in the 


object (Normal state) program's stack at step g, above. 
set the F Register to zero. 


Branch forward as many syllables as indicated by the 
number placed in the top of stack at 101 (octal in k, 


above). 


In this case, we will end up at the call MAKEPRESENT 
(ANALYSIS). Note that ANALYSIS is a typed (REAL) pro- 
cedure. Before entering MAKEPRESENT, we actually enter 
ANALYSIS, returning with a value to be passed as a para- 


meter to MAKEPRESENT. 
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APPENDIX A 
MCP COMMUNICATES 


To use the communicate operator, a normal state program first places 
a parameter in its stack. The word at the top of the stack is then 


stored in the cell addressed by R +9. The Communication Interrupt 
Bit is set and the MCP routine that handles this interrupt first 
locates R + 9 of the program that caused the interrupt. Then, accor- 
ding to this code value, the MCP transfers control to the section 

of the MCP designed to handle a communicate interrupt with that code. 
The operator is treated as a NOOP in control state. The following 


is a list of the codes used by the communicate operator: 


Code Description 
O Invalid End-of-Job in COBOL or FORTRAN. 
] TIME ((variable)) function in ALGOL. 


DATA ({data name)) function in COBOL. 


2 SLEEP call (wait) two parameters passed. 


3 Return specific array (pass array name 
and dimensions). 


uN ZIP WITH or PERFORM WITH array row or file name. 

5 Normal End-of-Job. Calls COM5 which calls 
SIGNOFF. 

6 WHEN function (pass number of seconds). 

7 Fill array row. 

8 ZIP (program-id) or PERFORM (program-id). 

9 Fill with inquiry. (Not applicable to data 


communications systems. ) 


10 Block Exit (ALGOL storage return). 


11 ALGOL I/O Function. Pass parameter as follows: 


APPENDIX A (cont) 


Code Description 
O = file open. 1 = parity message. 
2 = End-of-File message. 3 = End-of-Tape message. 
4 = data communications. 5 = return disk. 
6 = close file. 7 = process RER. 
8 = select error. 9 = space. 
10 = refill. 11 = read label. 
12 = IOREQ. 13 = rotate buffers. 
12 BREAK or RERUN. 
13 COBOL I/O Functions (OPEN and CLOSE only). 
14 Invert overlayable status of an array row. 
15 DISPLAY. 
16 ACCEPT. 
17 COBOL I/O errors (called from COBOLFCR or 
Sort Intrinsic). 
18 Inquiry Write (Not applicable to data 
communications. ) 
19 Printer Backup Routine (PRNPBT). 
20 Tape swap for tape sort. 
21 Get Space for sort. 
22 Return space from sort. 
23 Load Control (LDCNTRL). 
24 Return one row of a disk file. 
25 Return old copy of OWN array. 
26 Invalid arguments to intrinsics (LN, SQRT, etc.). 
ALGOL only. 
27 COBOL data communications interrogate. 
28 ALGOL data communications interrogate. 
29 Miscellaneous errors (error terminate). 
30 Directory search statement and label equation. 


31 ALGOL DELAY function. 


Code 


32 


33 
34 


APPENDIX A (cont) 


Description 
Data communications seeks, 


interrogates. 
FORTRAN PAUSE statement. 


FORTRAN error terminate. 


detaches, 


and 


Character 


Word word 
1 1-8 
2 1 
2 2-8 
3 dl. 
3 2-8 
4 1- 
4 4-8 
5 1-2 
5 3-7 
5 8 
6 1-5 
6-7 6-8/1-4 
7 > 
7-8 6-8/1-2 


APPENDIX B 
STANDARD B 5500 LABEL RECORD 


Character 
record 


1-8 


9 
10-16 
17 
18-24 
25-27 
28-32 


33-34 


32732 


LO 


41-45 
46-52 
53 


54-58 


Field 
Description 


Must contain bLABELbb. 
Must be zero. 

Multi-file identification. 
Must be zero. 

File identification. 


Reel-Number (within file). 


Date-Written (creation date). 


Cycle-Number (to distinguish 


between identical runs on 


the same day). 


Purge-Date (date this file 


can be destroyed). 


Sentinel (1 = End-of-Reel, 
O = End-of-File). 


Block Count. 
Record Count. 


Memory-Dump-Key (1 = memory 
dump follows label). 


Physical Tape Number. 


The remainder of the information contained in the label record 


varies for ALGOL and COBOL files as follows: 


Word 


Word 


Character 
word 


2 


Character 
word 


3-8 


APPENDIX B (cont) 


ALGOL FILES 


Character Rield 
(record) Description 
59 Blocking Indicator: 


blocked = 1 for (fixed logical) 
(fixed physical) 

= 3 for (fixed physical) 
(fixed logical) 
not blocked = 0 


60-64 Buffer Size (number of words). 

65-69 Maximum Record Size (number of 
words). 

70-72 Zeroes. 


COBOL FILES 


Character Field 
_(record) Description 
59-64 Reserved for File-Control-Routine 


- not currently being used. 


65=-?? Users Portion - may be of any for- 
mat desired by the user and may 
be up to 8,120 characters in 
length for tape files, up to 16 
characters in length for card 
file, and up to 56 characters in 


length for printer files. 


APPENDIX C 
CCMASK1 - CCMASK2 - MIXMASK - INFOMASK 


CCMASKs are used to check the validity of a control card entered 
via data communications. The variables CCMASK are used if a special 


mask is not provided by REMOTE/USERS. The CCMASK Table shows the 
card column used to set the bit in REMOTE/USERS, the associated bit 
with each control function, and those bits which are set in the 
standard mask. The MIXMASK is used in a similar way to check those 
input messages which may or must have a mix number preceding them. 
INFOMASK1 and INFOMASK2 are used to check the validity of those 
input messages which do not include a mix index. The three mask 


tables are now presented. 


The format for the CCMASK Card is as follows: 


Column Word CCMASK1 Bit Standard Mask 
1-23 - Not used 0-22 mm 
24 INFO 23 no 
25 USE 24 no 
26 RELEASE 25 no 
27 FREE 26 no 
28 PUBLIC 27 no 
29 USER 28 no 
30 RUN 29 yes 
31 COMPILE 30 yes 
32 EXECUTE 31 yes 
33 DUMP 32 no 
34 UNLOAD 33 no 
35 ADD 34 no 
36 LOAD 35 no 
37 REMOVE 36 no 
38 CHANGE 37 no 
39 UNIT 38 no 
Oo END 39 yes 
Ad DATA hO no 
42 LABEL AY no 
43 FILE 42 yes 
Ah EXPIRED 43 no 
As Not used Kh —— 
6 Not used AS — 
7 Not used 6 -=-- 
48 Not used 7 ae 


The format of the MIXMASK Card is as follows: 


Column 


49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
ya 
72 


Column 


OON NU FWNEH 


APPENDIX C (cont) 


Word 


Not used 
Not used 
PROCESS 
TO 
PRIORITY 
COMMON 
CORE 
STACK 
SAVE 

Not used 
Not used 
Not used 
ALGOL 
XALGOL 
FORTRAN 
LONALG 
BASTC 
Not used 
WITH 
COBOL 
LIBRARY 
SYNTAX 
FROM 

TO 


Word 


Not used 
DS 
IL 
OU 


CCMASK2 Bit 


WANN EWNHE O 


MIXMASK Bit 


WO ONNUFWNE O 


Standard Mask 


Standard Mask 


APPENDIX C (cont) 


Column Word MIXMASK Bit Standard Mask 
20 XS 19 no 
21 ES 20 .no 
ne SM ad yes 
23 HR 22 yes 
24 “65 23 no 
25 XT 24 no 
26 TL 25 no 
27 ss 26 no 
28 WU Pag no 
29 WA 28 no 
30 HM 29 no 
31 CU 30 no 


The format of the INFOMASK Card is as follows: 


Column Word INFORMASKI Bit Standard Mask 
Ay Not used O -_—— 
2 PG 1 no 
3 MX 2 yes 
y DD 3 no 
5 RW 4 no 
6 PD 5 yes 
¢ DB 6 no 
8 DP vi no 
9 DT 8 no 

10 DS 9 no 
11 PT 10 no 
12 RS gO 8 no 
13 EL 12 yes 
14 CC 13 yes 
15 PB 14 no 
16 RY 15 no 
AT TR 16 no 
18 OL 17 yes 
19 LN 18 no 
20 WD 19 yes 
21 wT 20 yes 
Ze LR 21 no 
23 RO pees no 
24 SO 23 no 
25 TO 24 yes 
26 SV 25 no 
2 LD 26 no 
28 CD 27 yes 
29 RD 28 no 
30 RN 29 no 
3A: ED 30 no 
32 CL ok no 
a TF 32 yes 


Word 


Not used 


APPENDIX C (cont) 


INFOMASK1 Bit 


33 
34 


INFORMASK2 Bit 


OOANNUEWNHE OO 


Standard Mask 


Mask 


Standard 


APPENDIX D 
USASCII X3.4 = 1967 STANDARD CODE 


sal Pads fat \! 
RAR SS ie ee eee 
rofofofo] o |nujoe | * | o | = |e [| s [e 
rofojo|y] 1 [sonjoc. | + | 1 [| a | @ [| = | a | 
ROO [Dore oe oie, pepe feet eg iar Rg 
fofo|ifi] 3 [ern focos [| * | 3 | ¢ | s [ec Js | 
PE RE Ec Oc Fl Se 
fofifofif 5  [ena[ nak | # [| 5 [| —€ [vu | e |v | 
Olt fol 6. yeack [svn |e.) ev 
fo ae | tee en 2 ee 
Fa ee a Se a ee ee 
pfofe ffs fos few fo fe fa fy J} tn 
Ea al a ee ee ee 
Field Meh ee coe cee cee Rs a (Dae 
ES Sek saa a (ee 
Ce ea ek De iy es = ed ee a ee 
Ee A Ye ee 
(Sa ae ee eee ae 

NUL Null DLE Data Link Escape (CC) 

SOH Start of Heading (CC) DC1 Device Control 1 

STX Start of Text (CC) DC2 Device Control 2 

ETX End of Text (CC) DC3 Device Control 3 

EOT End of Transmission (cc) DC4 Device Control (stop) 

ENQ Enquiry (CC) NAK Negative Acknowledge (CC) 

ACK Acknowledge (CC) SYN Synchronous Idle (CC) 

BEL - Bell (audible or atten- ETB End of Transmission 

signal) Block (CC) 
BS Backspace (FE) CAN Cancel 
HT Horizontal Tabulation EM End of Medium 


(punched card skip) (FE) 


APPENDIX D (cont) 


LF Line Feed (FE) oS Start of Special Sequence 
VT Vertical Tabulation (FE) ESC Escape 

FF Form Feed (FE) FS File Separator (IS) 

CR Carriage Return (FE) GS Group Separator (IS) 

SO Shift Out RS Record Separator (IS) 

SI Shift In US Unit Separator (IS) 


DEL Delete* 


NOTE 
(CC) Communication Control. 
(FE) Format Effector. 


(Is) Information Separator. 


The numbers in the left hand vertical column are the count contained 
in DAIF through DA4F or DBIF through DB4F. The numbers in the top 


horizontal row are the count contained in Dn5F through Dn6F. 


cE EAANAANA 


MULTI 


g 
& 
n 
~ + ~ ~ IA : Va 
° 
Zz 


eh 


*In the strict sense, DLE is not a control character. 


D-2 


Abort Table, 4-1 
Address, 6-1, 6-5, 6-6, 6-11 
absolute, 1-8 
Disk, 6-12 
Disk segment, 6-9 
relative, 6-15 
AUECOL,. SS hes “Bat 
Areas, 
auxiliary storage, 2-1 
core, 3-1 
Array, 1-7 
Date, 1-2 
Bed, 6-5 
Bits, 6-16, 9-1, C-1 
Flag, 1-8 
Block, 
File Information (FIB), 5-12 
File Parameter (FPB), 5-9 
Buffer, 6-20 
Pseudo, 5-17 
Card, 
Binary, 7-1 
Control entry, 4-11 
Control information, 4-5 
ESPOL Load, 7-10 
ESPOL Transfer, 7-8 
execute, 4-4 
file group, 4-16 
H/L, 7=2 . 
CCOMASK1, C-1 
CCMASK2, C-1 
Cells, 
PRT, 6-16 
Run Time Error (RTE), 1-8 


INDEX. 


COBOL, 5-17; 
Code, 


62 ty G17, Aad; 


USASCII Standard, D-1 


TInitializat 


ion, 7-14 


Internal Type, 5-16 


Type, 5-3 
Word, 4-5 
Communicates, 
MCP, A-1 
Compile, 4-4, 

-and-Go ent 

-Only entry 
Compiler, 6-1 
Components, 

B 5500, 1-1 
Computer, 

Programmers 
Control, 

Central, 9- 

T/0)..52 1 
Count, 

error, 6-3 
Counter, 

Block, 1-7 
Cycle, 4-7 
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